Streaming Endpoints - Update

Referenz

Dienst:: Media Services

API-Version:: 2022-11-01

Update StreamingEndpoint
Updates einen vorhandenen Streamingendpunkt.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string	Der Name des Media Services-Kontos.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.
streamingEndpointName	path	True	string	Der Name des Streamingendpunkts, die maximale Länge beträgt 24. RegEx-Muster: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
properties.scaleUnits	True	integer	Die Anzahl der Skalierungseinheiten. Verwenden Sie den Skalierungsvorgang, um diesen Wert anzupassen.
properties.accessControl		StreamingEndpointAccessControl	Die Zugriffssteuerungsdefinition des Streamingendpunkts.
properties.availabilitySetName		string	Dieses Feature ist veraltet, legen Sie keinen Wert für diese Eigenschaft fest.
properties.cdnEnabled		boolean	Das CDN-fähige Flag.
properties.cdnProfile		string	Der CDN-Profilname.
properties.cdnProvider		string	Der CDN-Anbietername.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Die Zugriffsrichtlinien für Streamingendpunkte.
properties.customHostNames		string[]	Die benutzerdefinierten Hostnamen des Streamingendpunkts
properties.description		string	Die Beschreibung des Streamingendpunkts.
properties.maxCacheAge		integer	Maximales Cachealter
sku		ArmStreamingEndpointCurrentSku	Die Streamingendpunkt-SKU.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	StreamingEndpoint	OK. Die Anforderung wurde erfolgreich durchgeführt.
202 Accepted	StreamingEndpoint	Akzeptiert: Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Weitere Informationen zur Überwachung asynchroner Azure-Vorgänge finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter.
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

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();
    }

    // Use "Map.of" if available
    @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

Beispiel für eine Antwort

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

Statuscode:: 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

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

Definitionen

Name	Beschreibung
AkamaiAccessControl	Akamai-Zugriffssteuerung
AkamaiSignatureHeaderAuthenticationKey	Authentifizierungsschlüssel des Akamai-Signaturheaders.
ArmStreamingEndpointCurrentSku	Die aktuelle SKU des Streamingendpunkts.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CrossSiteAccessPolicies	Die Clientzugriffsrichtlinie.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
IPAccessControl	Die IP-Zugriffssteuerung.
IPRange	Der IP-Adressbereich im CIDR-Schema.
StreamingEndpoint	Der Streamingendpunkt.
StreamingEndpointAccessControl	Definition der Zugriffssteuerung für Streamingendpunkte.
StreamingEndpointResourceState	Der Ressourcenstatus des Streamingendpunkts.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

AkamaiAccessControl

Akamai-Zugriffssteuerung

Name	Typ	Beschreibung
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	Authentifizierungsschlüsselliste

AkamaiSignatureHeaderAuthenticationKey

Authentifizierungsschlüssel des Akamai-Signaturheaders.

Name	Typ	Beschreibung
base64Key	string	Authentifizierungsschlüssel
expiration	string	Die Ablaufzeit des Authentifizierungsschlüssels.
identifier	string	Bezeichner des Schlüssels

ArmStreamingEndpointCurrentSku

Die aktuelle SKU des Streamingendpunkts.

Name	Typ	Beschreibung
capacity	integer	Die SKU-Kapazität des Streamingendpunkts.
name	string	Der SKU-Name des Streamingendpunkts.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Die Clientzugriffsrichtlinie.

Name	Typ	Beschreibung
clientAccessPolicy	string	Der Inhalt von clientaccesspolicy.xml, die von Silverlight verwendet werden.
crossDomainPolicy	string	Der Inhalt von crossdomain.xml, die von Silverlight verwendet werden.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

IPAccessControl

Die IP-Zugriffssteuerung.

Name	Typ	Beschreibung
allow	IPRange[]	Die IP-Zulassungsliste.

IPRange

Der IP-Adressbereich im CIDR-Schema.

Name	Typ	Beschreibung
address	string	Die IP-Adresse.
name	string	Der Anzeigename für den IP-Adressbereich.
subnetPrefixLength	integer	Die Präfixlänge der Subnetzmaske (siehe CIDR-Notation).