Streaming Endpoints - Update

Odwołanie

Service:: Media Services

API Version:: 2022-11-01

Aktualizowanie punktu końcowego przesyłania strumieniowego
Aktualizacje istniejącego punktu końcowego przesyłania strumieniowego.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
streamingEndpointName	path	True	string	Nazwa punktu końcowego przesyłania strumieniowego, maksymalna długość to 24. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API, która ma być używana z żądaniem klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
properties.scaleUnits	True	integer	Liczba jednostek skalowania. Użyj operacji skalowania, aby dostosować tę wartość.
properties.accessControl		StreamingEndpointAccessControl	Definicja kontroli dostępu punktu końcowego przesyłania strumieniowego.
properties.availabilitySetName		string	Ta funkcja jest przestarzała, nie ustawiaj wartości dla tej właściwości.
properties.cdnEnabled		boolean	Flaga włączona usługi CDN.
properties.cdnProfile		string	Nazwa profilu usługi CDN.
properties.cdnProvider		string	Nazwa dostawcy usługi CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Zasady dostępu do punktu końcowego przesyłania strumieniowego.
properties.customHostNames		string[]	Niestandardowe nazwy hostów punktu końcowego przesyłania strumieniowego
properties.description		string	Opis punktu końcowego przesyłania strumieniowego.
properties.maxCacheAge		integer	Maksymalny wiek pamięci podręcznej
sku		ArmStreamingEndpointCurrentSku	Jednostka SKU punktu końcowego przesyłania strumieniowego.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	StreamingEndpoint	OK. Żądanie zakończyło się pomyślnie.
202 Accepted	StreamingEndpoint	Akceptowane. Żądanie zostało zaakceptowane na potrzeby przetwarzania, a operacja zostanie ukończona asynchronicznie. Zobacz https://go.microsoft.com/fwlink/?linkid=2087017 , aby uzyskać szczegółowe informacje na temat asynchronicznych operacji platformy Azure monitorowania.
Other Status Codes	ErrorResponse	Odpowiedź z błędem przesyłania strumieniowego opisująca, dlaczego operacja nie powiodła się.

Przykłady

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

Definicje

Nazwa	Opis
AkamaiAccessControl	Kontrola dostępu Akamai
AkamaiSignatureHeaderAuthenticationKey	Klucz uwierzytelniania nagłówka podpisu Akamai.
ArmStreamingEndpointCurrentSku	Bieżąca jednostka SKU punktu końcowego przesyłania strumieniowego.
createdByType	Typ tożsamości, która utworzyła zasób.
CrossSiteAccessPolicies	Zasady dostępu klienta.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IPAccessControl	Kontrola dostępu do adresu IP.
IPRange	Zakres adresów IP w schemacie CIDR.
StreamingEndpoint	Punkt końcowy przesyłania strumieniowego.
StreamingEndpointAccessControl	Definicja kontroli dostępu punktu końcowego przesyłania strumieniowego.
StreamingEndpointResourceState	Stan zasobu punktu końcowego przesyłania strumieniowego.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AkamaiAccessControl

Kontrola dostępu Akamai

Nazwa	Typ	Opis
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	lista kluczy uwierzytelniania

AkamaiSignatureHeaderAuthenticationKey

Klucz uwierzytelniania nagłówka podpisu Akamai.

Nazwa	Typ	Opis
base64Key	string	klucz uwierzytelniania
expiration	string	Czas wygaśnięcia klucza uwierzytelniania.
identifier	string	identyfikator klucza

ArmStreamingEndpointCurrentSku

Bieżąca jednostka SKU punktu końcowego przesyłania strumieniowego.

Nazwa	Typ	Opis
capacity	integer	Pojemność jednostki SKU punktu końcowego przesyłania strumieniowego.
name	string	Nazwa jednostki SKU punktu końcowego przesyłania strumieniowego.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Zasady dostępu klienta.

Nazwa	Typ	Opis
clientAccessPolicy	string	Zawartość clientaccesspolicy.xml używana przez program Silverlight.
crossDomainPolicy	string	Zawartość crossdomain.xml używana przez program Silverlight.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

IPAccessControl

Kontrola dostępu do adresu IP.

Nazwa	Typ	Opis
allow	IPRange[]	Lista dozwolonych adresów IP.

IPRange

Zakres adresów IP w schemacie CIDR.

Nazwa	Typ	Opis
address	string	Adres IP.
name	string	Przyjazna nazwa zakresu adresów IP.
subnetPrefixLength	integer	Długość prefiksu maski podsieci (zobacz notacja CIDR).