Conectar-se à API de Serviços de Mídia v3 – Python

logotipo dos Serviços de Mídia v3


Você está procurando a documentação dos Serviços de Mídia v2?

Este artigo mostra como se conectar ao SDK do Python dos Serviços de Mídia do Azure v3 usando o método de entrada da entidade de serviço.

Pré-requisitos

  • Baixe o Python do site python.org
  • Lembre-se de definir a variável de ambiente PATH
  • Crie uma conta de Serviços de Mídia. Lembre-se do nome do grupo de recursos e da conta dos Serviços de Mídia.
  • Siga as etapas no tópico APIs de acesso selecionando o método de autenticação de entidade de serviço. Registre a ID da assinatura (SubscriptionId), a ID do cliente do aplicativo (AadClientId), a chave de autenticação (AadSecret) e a ID do locatário (AadTenantId) que você precisa em etapas posteriores.

Importante

Examine Convenções de nomenclatura.

Instalar os módulos

Para trabalhar com os Serviços de Mídia do Azure usando o Python, você precisa instalar esses módulos.

Abra uma ferramenta de linha de comando e use os comandos a seguir para instalar os módulos.

pip3 install azure-mgmt-resource
pip3 install azure-mgmt-media==3.0.0

Conectar-se ao cliente Python

  1. Crie um arquivo com uma extensão .py

  2. Abra o arquivo em seu editor favorito

  3. Adicione o código a seguir ao arquivo. O código importa os módulos necessários e cria o objeto de credenciais do Active Directory de que você precisa para se conectar aos Serviços de Mídia.

    Defina os valores das variáveis para os valores obtidos das APIs de Acesso. Atualize as variáveis ACCOUNT_NAME e RESOUCE_GROUP_NAME para o nome da conta dos Serviços de Mídia e os nomes do grupo de recursos usados ao criar esses recursos.

    import adal
    from azure.mgmt.media import AzureMediaServices
    from msrestazure.azure_active_directory import AdalAuthentication
    from msrestazure.azure_cloud import AZURE_PUBLIC_CLOUD
    
    RESOURCE = "https://management.core.windows.net/"
    # Tenant ID for your Azure Subscription (AadTenantId)
    TENANT_ID = "00000000-0000-0000-000000000000"
    # Your Service Principal App ID (AadClientId)
    CLIENT = "00000000-0000-0000-000000000000"
    # Your Service Principal Password (AadSecret)
    KEY = "00000000-0000-0000-000000000000"
    # Your Azure Subscription ID (SubscriptionId)
    SUBSCRIPTION_ID = "00000000-0000-0000-000000000000"
    # Your Azure Media Service (AMS) Account Name
    ACCOUNT_NAME = "amsaccount"
    # Your Resource Group Name
    RESOUCE_GROUP_NAME = "amsResourceGroup"
    
    LOGIN_ENDPOINT = AZURE_PUBLIC_CLOUD.endpoints.active_directory
    RESOURCE = AZURE_PUBLIC_CLOUD.endpoints.active_directory_resource_id
    
    context = adal.AuthenticationContext(LOGIN_ENDPOINT + "/" + TENANT_ID)
    credentials = AdalAuthentication(
        context.acquire_token_with_client_credentials, RESOURCE, CLIENT, KEY
    )
    
    # The AMS Client
    # You can now use this object to perform different operations to your AMS account.
    client = AzureMediaServices(credentials, SUBSCRIPTION_ID)
    
    print("signed in")
    
    # Now that you are authenticated, you can manipulate the entities.
    # For example, list assets in your AMS account
    print(client.assets.list(RESOUCE_GROUP_NAME, ACCOUNT_NAME).get(0))
    
  4. Execute o arquivo

Próximas etapas