Streaming Endpoints - Update

Référence

Service:: Media Services

API Version:: 2022-11-01

Update StreamingEndpoint
Mises à jour un point de terminaison de streaming existant.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte Media Services.
resourceGroupName	path	True	string	Nom du groupe de ressources au sein de l’abonnement Azure.
streamingEndpointName	path	True	string	Le nom du point de terminaison de streaming, dont la longueur maximale est 24. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Identificateur unique d’un abonnement Microsoft Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
properties.scaleUnits	True	integer	Nombre d’unités d’échelle. Utilisez l’opération de mise à l’échelle pour ajuster cette valeur.
properties.accessControl		StreamingEndpointAccessControl	Définition du contrôle d’accès du point de terminaison de streaming.
properties.availabilitySetName		string	Cette fonctionnalité est déconseillée, ne définissez pas de valeur pour cette propriété.
properties.cdnEnabled		boolean	Indicateur cdn activé.
properties.cdnProfile		string	Nom du profil CDN.
properties.cdnProvider		string	Nom du fournisseur CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Stratégies d’accès au point de terminaison de streaming.
properties.customHostNames		string[]	Noms d’hôte personnalisés du point de terminaison de streaming
properties.description		string	Description du point de terminaison de streaming.
properties.maxCacheAge		integer	Âge maximal du cache
sku		ArmStreamingEndpointCurrentSku	Référence SKU du point de terminaison de streaming.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	StreamingEndpoint	OK. La demande a réussi.
202 Accepted	StreamingEndpoint	Accepté. La demande a été acceptée pour traitement et l’opération se termine de manière asynchrone. Pour plus d’informations sur la surveillance des opérations asynchrones Azure, consultez https://go.microsoft.com/fwlink/?linkid=2087017 .
Other Status Codes	ErrorResponse	Réponse d’erreur de diffusion en continu décrivant la raison de l’échec de l’opération.

Exemples

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

Définitions

Nom	Description
AkamaiAccessControl	Contrôle d’accès Akamai
AkamaiSignatureHeaderAuthenticationKey	Clé d’authentification de l’en-tête de signature Akamai.
ArmStreamingEndpointCurrentSku	Référence SKU actuelle du point de terminaison de streaming.
createdByType	Type d’identité qui a créé la ressource.
CrossSiteAccessPolicies	Stratégie d’accès au client.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
IPAccessControl	Contrôle d’accès IP.
IPRange	Plage d’adresses IP dans le schéma CIDR.
StreamingEndpoint	Point de terminaison de streaming.
StreamingEndpointAccessControl	Définition du contrôle d’accès au point de terminaison de streaming.
StreamingEndpointResourceState	État de la ressource du point de terminaison de streaming.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

AkamaiAccessControl

Contrôle d’accès Akamai

Nom	Type	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	liste de clés d’authentification

AkamaiSignatureHeaderAuthenticationKey

Clé d’authentification de l’en-tête de signature Akamai.

Nom	Type	Description
base64Key	string	clé d’authentification
expiration	string	Heure d’expiration de la clé d’authentification.
identifier	string	identificateur de la clé

ArmStreamingEndpointCurrentSku

Référence SKU actuelle du point de terminaison de streaming.

Nom	Type	Description
capacity	integer	Capacité de référence SKU du point de terminaison de streaming.
name	string	Nom de la référence SKU du point de terminaison de streaming.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Stratégie d’accès au client.

Nom	Type	Description
clientAccessPolicy	string	Le contenu de clientaccesspolicy.xml utilisé par Silverlight.
crossDomainPolicy	string	Le contenu de crossdomain.xml utilisé par Silverlight.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet error.

IPAccessControl

Contrôle d’accès IP.

Nom	Type	Description
allow	IPRange[]	Liste d’adresses IP autorisées.

IPRange

Plage d’adresses IP dans le schéma CIDR.

Nom	Type	Description
address	string	Adresse IP.
name	string	Nom convivial de la plage d’adresses IP.
subnetPrefixLength	integer	Longueur du préfixe du masque de sous-réseau (voir notation CIDR).