# LiveEventPreview

## accessControl

### PreviewAccessControl

**Optional**  
Address-based ACLs for access to the preview.

---

## ip

### IPAccessControl

**Required**  
The IP access control for the preview endpoint. Determines who will be able to access preview content.

---

### allowlist

**Required**  
The IP ranges that will be allowed to access the preview. If empty, all IPs will be allowed.

- **address**: string **Required**  
  The IP address or DNS with port or protocol
- **name**: string **Required** (1-32 characters)  
  The name of the IP range. This is for your reference only. Examples: 'everyone', 'dave's house', 'corp vpn'.
- **subnetPrefixLength**: integer **Required** (0 to 32)  
  The subnet prefix length (see CIDR notation).
- **alternativeMediaId**: string **Optional**  
  Not currently supported. Will be used to support DRM license acquisition for preview content.

---

## endpoints

**Optional**  
Populated server-side. The endpoints that are used for previewing the live event.

- **protocol**: string **Optional**  
  The streaming protocol for the endpoint. Possible values include: 'SRT', 'RTMP'.
- **url**: string **Optional**  
  The IP address or DNS with port and protocol.

---

### previewLocator

**Optional** (format: uuid)  
The ID of the locator for the preview. This is automatically generated when the live event is created, and removed when the live event is deleted. The caller may specify a locator GUID, in which case the caller must ensure that the GUID is unique and not already used by another resource.

---

### streamingPolicyName

**Optional** (<=260 characters): Defaults to Predefined_ClearStreamingOnly  
The name of the DRM streaming policy for the live event preview. Defaults to Predefined_ClearStreamingOnly and no other value is presently supported.
