Streaming Endpoints - Update

Riferimento

Service:: Media Services

API Version:: 2022-11-01

Aggiornare un'entità StreamingEndpoint
Aggiornamenti un endpoint di streaming esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
streamingEndpointName	path	True	string	Il nome dell'endpoint di streaming, la lunghezza massima è 24. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.scaleUnits	True	integer	Numero di unità di scala. Utilizzare l'operazione Scala per modificare questo valore.
properties.accessControl		StreamingEndpointAccessControl	Definizione del controllo di accesso dell'endpoint di streaming.
properties.availabilitySetName		string	Questa funzionalità è deprecata, non impostare un valore per questa proprietà.
properties.cdnEnabled		boolean	Flag abilitato per la rete CDN.
properties.cdnProfile		string	Nome del profilo della rete CDN.
properties.cdnProvider		string	Nome del provider della rete CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Criteri di accesso agli endpoint di streaming.
properties.customHostNames		string[]	Nomi host personalizzati dell'endpoint di streaming
properties.description		string	Descrizione dell'endpoint di streaming.
properties.maxCacheAge		integer	Validità massima cache
sku		ArmStreamingEndpointCurrentSku	SKU dell'endpoint di streaming.
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	StreamingEndpoint	OK. La richiesta ha avuto esito positivo.
202 Accepted	StreamingEndpoint	Accettato. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Vedere https://go.microsoft.com/fwlink/?linkid=2087017 per informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure.
Other Status Codes	ErrorResponse	Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

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"
  }
}

Definizioni

Nome	Descrizione
AkamaiAccessControl	Controllo di accesso Akamai
AkamaiSignatureHeaderAuthenticationKey	Chiave di autenticazione dell'intestazione della firma Akamai.
ArmStreamingEndpointCurrentSku	SKU corrente dell'endpoint di streaming.
createdByType	Tipo di identità che ha creato la risorsa.
CrossSiteAccessPolicies	Criteri di accesso client.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
IPAccessControl	Controllo di accesso IP.
IPRange	Intervallo di indirizzi IP nello schema CIDR.
StreamingEndpoint	Endpoint di streaming.
StreamingEndpointAccessControl	Definizione del controllo di accesso dell'endpoint di streaming.
StreamingEndpointResourceState	Stato della risorsa dell'endpoint di streaming.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AkamaiAccessControl

Controllo di accesso Akamai

Nome	Tipo	Descrizione
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	elenco di chiavi di autenticazione

AkamaiSignatureHeaderAuthenticationKey

Chiave di autenticazione dell'intestazione della firma Akamai.

Nome	Tipo	Descrizione
base64Key	string	chiave di autenticazione
expiration	string	Ora di scadenza della chiave di autenticazione.
identifier	string	identificatore della chiave

ArmStreamingEndpointCurrentSku

SKU corrente dell'endpoint di streaming.

Nome	Tipo	Descrizione
capacity	integer	Capacità dello SKU dell'endpoint di streaming.
name	string	Nome sku dell'endpoint di streaming.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Criteri di accesso client.

Nome	Tipo	Descrizione
clientAccessPolicy	string	Contenuto di clientaccesspolicy.xml utilizzato da Silverlight.
crossDomainPolicy	string	Contenuto di crossdomain.xml utilizzato da Silverlight.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

IPAccessControl

Controllo di accesso IP.

Nome	Tipo	Descrizione
allow	IPRange[]	Elenco indirizzi IP consentiti.

IPRange

Intervallo di indirizzi IP nello schema CIDR.

Nome	Tipo	Descrizione
address	string	Indirizzo IP.
name	string	Nome descrittivo per l'intervallo di indirizzi IP.
subnetPrefixLength	integer	Lunghezza del prefisso della subnet mask (vedere notazione CIDR).