Assets - List Container Sas

Reference

Služba:: Media Services

Verze rozhraní API:: 2022-08-01

Výpis adres URL prostředků
Seznamy adresy URL kontejneru úložiště se sdílenými přístupovými podpisy (SAS) pro nahrávání a stahování obsahu prostředků. Podpisy jsou odvozené z klíčů účtu úložiště.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/assets/{assetName}/listContainerSas?api-version=2022-08-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountName	path	True	string	Název účtu služby Media Services.
assetName	path	True	string	Název prostředku.
resourceGroupName	path	True	string	Název skupiny prostředků v rámci předplatného Azure.
subscriptionId	path	True	string	Jedinečný identifikátor předplatného Microsoft Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít s žádostí klienta.

Text požadavku

Name	Typ	Description
expiryTime	string	Doba vypršení platnosti adresy URL SAS. To musí být méně než 24 hodin od aktuálního času.
permissions	AssetContainerPermission	Oprávnění, která se mají nastavit na adrese URL SAS.

Odpovědi

Name	Typ	Description
200 OK	AssetContainerSas	OK
Other Status Codes	ErrorResponse	Podrobné informace o chybě

Příklady

List Asset SAS URLs

Ukázkový požadavek

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/assets/ClimbingMountBaker/listContainerSas?api-version=2022-08-01

{
  "permissions": "ReadWrite",
  "expiryTime": "2018-01-01T10:00:00.007Z"
}


import com.azure.resourcemanager.mediaservices.models.AssetContainerPermission;
import com.azure.resourcemanager.mediaservices.models.ListContainerSasInput;
import java.time.OffsetDateTime;

/**
 * Samples for Assets ListContainerSas.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-sas-
     * urls.json
     */
    /**
     * Sample code: List Asset SAS URLs.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void listAssetSASURLs(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.assets().listContainerSasWithResponse("contosorg", "contosomedia", "ClimbingMountBaker",
            new ListContainerSasInput().withPermissions(AssetContainerPermission.READ_WRITE)
                .withExpiryTime(OffsetDateTime.parse("2018-01-01T10:00:00.007Z")),
            com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-media
# USAGE
    python assetslistsasurls.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = AzureMediaServices(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.assets.list_container_sas(
        resource_group_name="contoso",
        account_name="contosomedia",
        asset_name="ClimbingMountBaker",
        parameters={"expiryTime": "2018-01-01T10:00:00.007Z", "permissions": "ReadWrite"},
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-sas-urls.json
if __name__ == "__main__":
    main()

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

package armmediaservices_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e7bf3adfa2d5e5cdbb804eec35279501794f461c/specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-sas-urls.json
func ExampleAssetsClient_ListContainerSas() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAssetsClient().ListContainerSas(ctx, "contoso", "contosomedia", "ClimbingMountBaker", armmediaservices.ListContainerSasInput{
		ExpiryTime:  to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-01T10:00:00.007Z"); return t }()),
		Permissions: to.Ptr(armmediaservices.AssetContainerPermissionReadWrite),
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.AssetContainerSas = armmediaservices.AssetContainerSas{
	// 	AssetContainerSasUrls: []*string{
	// 		to.Ptr("https://storage0.blob.core.windows.net/asset-89af1750-e681-4fbe-8c4c-9a5567867a6b?sr=b&sig=<secret-value-from-key-1>&se=2018-01-01T10:00:00Z&sp=lrw"),
	// 		to.Ptr("https://storage0.blob.core.windows.net/asset-89af1750-e681-4fbe-8c4c-9a5567867a6b?sr=b&sig=<secret-value-from-key-2>&se=2018-01-01T10:00:00Z&sp=lrw")},
	// 	}
}

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

const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists storage container URLs with shared access signatures (SAS) for uploading and downloading Asset content. The signatures are derived from the storage account keys.
 *
 * @summary Lists storage container URLs with shared access signatures (SAS) for uploading and downloading Asset content. The signatures are derived from the storage account keys.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-sas-urls.json
 */
async function listAssetSasUrLs() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contoso";
  const accountName = "contosomedia";
  const assetName = "ClimbingMountBaker";
  const parameters = {
    expiryTime: new Date("2018-01-01T10:00:00.007Z"),
    permissions: "ReadWrite",
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.assets.listContainerSas(
    resourceGroupName,
    accountName,
    assetName,
    parameters
  );
  console.log(result);
}

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

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
using Azure.ResourceManager.Media.Models;

// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-sas-urls.json
// this example is just showing the usage of "Assets_ListContainerSas" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this MediaAssetResource created on azure
// for more information of creating MediaAssetResource, please refer to the document of MediaAssetResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contoso";
string accountName = "contosomedia";
string assetName = "ClimbingMountBaker";
ResourceIdentifier mediaAssetResourceId = MediaAssetResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, assetName);
MediaAssetResource mediaAsset = client.GetMediaAssetResource(mediaAssetResourceId);

// invoke the operation and iterate over the result
MediaAssetStorageContainerSasContent content = new MediaAssetStorageContainerSasContent()
{
    Permissions = MediaAssetContainerPermission.ReadWrite,
    ExpireOn = DateTimeOffset.Parse("2018-01-01T10:00:00.007Z"),
};
await foreach (Uri item in mediaAsset.GetStorageContainerUrisAsync(content))
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine($"Succeeded");

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

Ukázková odpověď

Stavový kód:: 200

{
  "assetContainerSasUrls": [
    "https://storage0.blob.core.windows.net/asset-89af1750-e681-4fbe-8c4c-9a5567867a6b?sr=b&sig=<secret-value-from-key-1>&se=2018-01-01T10:00:00Z&sp=lrw",
    "https://storage0.blob.core.windows.net/asset-89af1750-e681-4fbe-8c4c-9a5567867a6b?sr=b&sig=<secret-value-from-key-2>&se=2018-01-01T10:00:00Z&sp=lrw"
  ]
}

Definice

Name	Description
AssetContainerPermission	Oprávnění, která se mají nastavit na adrese URL SAS.
AssetContainerSas	Adresy URL SAS kontejneru Asset Storage.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Odpověď na chybu
ListContainerSasInput	Parametry pro požadavek SAS vypíše.

AssetContainerPermission

Oprávnění, která se mají nastavit na adrese URL SAS.

Name	Typ	Description
Read	string	Adresa URL SAS umožní kontejneru přístup pro čtení.
ReadWrite	string	Adresa URL SAS umožní ke kontejneru přístup pro čtení a zápis.
ReadWriteDelete	string	Adresa URL SAS umožní čtení, zápis a odstranění přístupu ke kontejneru.

AssetContainerSas

Adresy URL SAS kontejneru Asset Storage.

Name	Typ	Description
assetContainerSasUrls	string[]	Seznam adres URL SAS kontejneru prostředků.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě
code	string	Kód chyby
details	ErrorDetail[]	Podrobnosti o chybě
message	string	Chybová zpráva
target	string	Cíl chyby.

ErrorResponse

Odpověď na chybu

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ListContainerSasInput

Parametry pro požadavek SAS vypíše.

Name	Typ	Description
expiryTime	string	Doba vypršení platnosti adresy URL SAS. To musí být méně než 24 hodin od aktuálního času.
permissions	AssetContainerPermission	Oprávnění, která se mají nastavit na adrese URL SAS.