Streaming Endpoints - Update

Referência

Service:: Media Services

API Version:: 2022-11-01

Atualizar StreamingEndpoint
Atualizações um ponto de extremidade de streaming existente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/streamingEndpoints/{streamingEndpointName}?api-version=2022-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Mídia.
resourceGroupName	path	True	string	O nome do grupo de recursos na assinatura do Azure.
streamingEndpointName	path	True	string	O nome do ponto de extremidade de streaming, o comprimento máximo é 24. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	O identificador exclusivo de uma assinatura do Microsoft Azure.
api-version	query	True	string	A versão da API a ser usada com a solicitação do cliente.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	A localização geográfica em que o recurso reside
properties.scaleUnits	True	integer	O número de unidades de escala. Use a operação Escala para ajustar esse valor.
properties.accessControl		StreamingEndpointAccessControl	A definição de controle de acesso do ponto de extremidade de streaming.
properties.availabilitySetName		string	Esse recurso foi preterido, não defina um valor para essa propriedade.
properties.cdnEnabled		boolean	O sinalizador habilitado para CDN.
properties.cdnProfile		string	O nome do perfil da CDN.
properties.cdnProvider		string	O nome do provedor da CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	As políticas de acesso do ponto de extremidade de streaming.
properties.customHostNames		string[]	Os nomes de host personalizados do ponto de extremidade de streaming
properties.description		string	A descrição do ponto de extremidade de streaming.
properties.maxCacheAge		integer	Idade máxima do cache
sku		ArmStreamingEndpointCurrentSku	A SKU do ponto de extremidade de streaming.
tags		object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	StreamingEndpoint	OK. A solicitação foi bem-sucedida.
202 Accepted	StreamingEndpoint	Aceita. A solicitação foi aceita para processamento e a operação será concluída de forma assíncrona. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre o monitoramento de operações assíncronas do Azure.
Other Status Codes	ErrorResponse	A resposta de erro de streaming que descreve por que a operação falhou.

Exemplos

Update a streaming endpoint

PATCH https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingEndpoints/myStreamingEndpoint1?api-version=2022-11-01

{
  "location": "West US",
  "tags": {
    "tag3": "value3",
    "tag5": "value5"
  },
  "properties": {
    "description": "test event 2",
    "scaleUnits": 5,
    "availabilitySetName": "availableset"
  }
}

import com.azure.resourcemanager.mediaservices.models.StreamingEndpoint;
import java.util.HashMap;
import java.util.Map;

/** Samples for StreamingEndpoints Update. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/streamingendpoint-update.json
     */
    /**
     * Sample code: Update a streaming endpoint.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void updateAStreamingEndpoint(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        StreamingEndpoint resource =
            manager
                .streamingEndpoints()
                .getWithResponse(
                    "mediaresources", "slitestmedia10", "myStreamingEndpoint1", com.azure.core.util.Context.NONE)
                .getValue();
        resource
            .update()
            .withTags(mapOf("tag3", "value3", "tag5", "value5"))
            .withDescription("test event 2")
            .withScaleUnits(5)
            .withAvailabilitySetName("availableset")
            .apply();
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "name": "myStreamingEndpoint1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1",
  "type": "Microsoft.Media/mediaservices/streamingEndpoints",
  "location": "West US",
  "tags": {
    "tag3": "value3",
    "tag5": "value5"
  },
  "properties": {
    "description": "test event 2",
    "scaleUnits": 5,
    "availabilitySetName": "availableset",
    "cdnEnabled": false,
    "cdnProvider": null,
    "cdnProfile": null,
    "customHostNames": [],
    "maxCacheAge": null,
    "hostName": null,
    "freeTrialEndTime": "0001-01-01T00:00:00Z",
    "provisioningState": "Succeeded",
    "resourceState": null,
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z"
  }
}

Status code:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpointoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

Response Body

{
  "name": "myStreamingEndpoint1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1",
  "type": "Microsoft.Media/mediaservices/streamingEndpoints",
  "location": "West US",
  "tags": {
    "tag3": "value3",
    "tag5": "value5"
  },
  "properties": {
    "description": "test event 2",
    "scaleUnits": 5,
    "availabilitySetName": "availableset",
    "cdnEnabled": false,
    "cdnProvider": null,
    "cdnProfile": null,
    "customHostNames": [],
    "maxCacheAge": null,
    "hostName": null,
    "freeTrialEndTime": "0001-01-01T00:00:00Z",
    "provisioningState": "Succeeded",
    "resourceState": null,
    "created": "0001-01-01T00:00:00Z",
    "lastModified": "0001-01-01T00:00:00Z"
  }
}

Definições

Nome	Description
AkamaiAccessControl	Controle de acesso do Akamai
AkamaiSignatureHeaderAuthenticationKey	Chave de autenticação do Cabeçalho de Assinatura do Akamai.
ArmStreamingEndpointCurrentSku	O SKU atual do ponto de extremidade de streaming.
createdByType	O tipo de identidade que criou o recurso.
CrossSiteAccessPolicies	A política de acesso do cliente.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	Os detalhes do erro.
ErrorResponse	Resposta de erro
IPAccessControl	O controle de acesso ip.
IPRange	O intervalo de endereços IP no esquema CIDR.
StreamingEndpoint	O ponto de extremidade de streaming.
StreamingEndpointAccessControl	Definição de controle de acesso do ponto de extremidade de streaming.
StreamingEndpointResourceState	O estado do recurso do ponto de extremidade de streaming.
systemData	Metadados relativos à criação e à última modificação do recurso.

AkamaiAccessControl

Controle de acesso do Akamai

Nome	Tipo	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	lista de chaves de autenticação

AkamaiSignatureHeaderAuthenticationKey

Chave de autenticação do Cabeçalho de Assinatura do Akamai.

Nome	Tipo	Description
base64Key	string	chave de autenticação
expiration	string	O tempo de expiração da chave de autenticação.
identifier	string	identificador da chave

ArmStreamingEndpointCurrentSku

O SKU atual do ponto de extremidade de streaming.

Nome	Tipo	Description
capacity	integer	A capacidade de SKU do ponto de extremidade de streaming.
name	string	O nome da SKU do ponto de extremidade de streaming.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

A política de acesso do cliente.

Nome	Tipo	Description
clientAccessPolicy	string	O conteúdo de clientaccesspolicy.xml usado pelo Silverlight.
crossDomainPolicy	string	O conteúdo de crossdomain.xml usado pelo Silverlight.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Os detalhes do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

IPAccessControl

O controle de acesso ip.

Nome	Tipo	Description
allow	IPRange[]	A lista de permissões de IP.

IPRange

O intervalo de endereços IP no esquema CIDR.

Nome	Tipo	Description
address	string	O endereço IP.
name	string	O nome amigável para o intervalo de endereços IP.
subnetPrefixLength	integer	O comprimento do prefixo da máscara de sub-rede (consulte notação CIDR).