Operations Discovery - Get

Referência

Service:: Resource Mover

API Version:: 2023-08-01

GET https://management.azure.com/providers/Microsoft.Migrate/operations?api-version=2023-08-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
api-version	query	True	string	Versão da API do Cliente.

Respostas

Name	Tipo	Description
200 OK	OperationsDiscoveryCollection	Com êxito
Other Status Codes	CloudError	Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

OperationsDiscovery_Get

Sample Request

GET https://management.azure.com/providers/Microsoft.Migrate/operations?api-version=2023-08-01

/** Samples for OperationsDiscovery Get. */
public final class Main {
    /*
     * x-ms-original-file: specification/resourcemover/resource-manager/Microsoft.Migrate/stable/2023-08-01/examples/OperationsDiscovery_Get.json
     */
    /**
     * Sample code: OperationsDiscovery_Get.
     *
     * @param manager Entry point to ResourceMoverManager.
     */
    public static void operationsDiscoveryGet(com.azure.resourcemanager.resourcemover.ResourceMoverManager manager) {
        manager.operationsDiscoveries().getWithResponse(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.resourcemover import ResourceMoverServiceAPI

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resourcemover
# USAGE
    python operations_discovery_get.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 = ResourceMoverServiceAPI(
        credential=DefaultAzureCredential(),
        subscription_id="c183865e-6077-46f2-a3b1-deb0f4f4650a",
    )

    response = client.operations_discovery.get()
    print(response)


# x-ms-original-file: specification/resourcemover/resource-manager/Microsoft.Migrate/stable/2023-08-01/examples/OperationsDiscovery_Get.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 armresourcemover_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resourcemover/armresourcemover"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/3066a973f4baf2e2bf072a013b585a820bb10146/specification/resourcemover/resource-manager/Microsoft.Migrate/stable/2023-08-01/examples/OperationsDiscovery_Get.json
func ExampleOperationsDiscoveryClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresourcemover.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewOperationsDiscoveryClient().Get(ctx, 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.OperationsDiscoveryCollection = armresourcemover.OperationsDiscoveryCollection{
	// 	Value: []*armresourcemover.OperationsDiscovery{
	// 		{
	// 			Name: to.Ptr("Read"),
	// 			Display: &armresourcemover.Display{
	// 				Description: to.Ptr("Reads the move collection."),
	// 				Operation: to.Ptr("Read"),
	// 				Provider: to.Ptr("Microsoft.Migrate"),
	// 				Resource: to.Ptr("Microsoft.Migrate/moveCollections"),
	// 			},
	// 			Origin: to.Ptr("user"),
	// 		},
	// 		{
	// 			Name: to.Ptr("Write"),
	// 			Display: &armresourcemover.Display{
	// 				Description: to.Ptr("Creates or updates a move collection."),
	// 				Operation: to.Ptr("Write"),
	// 				Provider: to.Ptr("Microsoft.Migrate"),
	// 				Resource: to.Ptr("Microsoft.Migrate/moveCollections"),
	// 			},
	// 			Origin: to.Ptr("user"),
	// 	}},
	// }
}

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

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

/**
 * This sample demonstrates how to
 *
 * @summary
 * x-ms-original-file: specification/resourcemover/resource-manager/Microsoft.Migrate/stable/2023-08-01/examples/OperationsDiscovery_Get.json
 */
async function operationsDiscoveryGet() {
  const credential = new DefaultAzureCredential();
  const client = new ResourceMoverServiceAPI(credential);
  const result = await client.operationsDiscoveryOperations.get();
  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.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.ResourceMover;
using Azure.ResourceManager.ResourceMover.Models;

// Generated from example definition: specification/resourcemover/resource-manager/Microsoft.Migrate/stable/2023-08-01/examples/OperationsDiscovery_Get.json
// this example is just showing the usage of "OperationsDiscovery_Get" 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 TenantResource created on azure
// for more information of creating TenantResource, please refer to the document of TenantResource
var tenantResource = client.GetTenants().GetAllAsync().GetAsyncEnumerator().Current;

// invoke the operation and iterate over the result
await foreach (MoverOperationsDiscovery item in tenantResource.GetOperationsDiscoveriesAsync())
{
    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

Sample Response

Status code:: 200

{
  "value": [
    {
      "name": "Read",
      "display": {
        "provider": "Microsoft.Migrate",
        "resource": "Microsoft.Migrate/moveCollections",
        "operation": "Read",
        "description": "Reads the move collection."
      },
      "origin": "user"
    },
    {
      "name": "Write",
      "display": {
        "provider": "Microsoft.Migrate",
        "resource": "Microsoft.Migrate/moveCollections",
        "operation": "Write",
        "description": "Creates or updates a move collection."
      },
      "origin": "user"
    }
  ]
}

Definições

Name	Description
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
Display	Contém as informações de apresentação localizadas para esta operação/ação específica. Estes valores serão utilizados por vários clientes para (1) definições de funções personalizadas para RBAC; (2) filtros de consulta complexos para o serviço de eventos; e (3) histórico/registos de auditoria para operações de gestão.
OperationsDiscovery	Classe de deteção de operações.
OperationsDiscoveryCollection	Coleção de detalhes de ClientDiscovery.

CloudError

Uma resposta de erro do serviço.

Name	Tipo	Description
error	CloudErrorBody	Corpo do erro da cloud.

CloudErrorBody

Uma resposta de erro do serviço.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, que se destina a ser adequada para ser apresentada numa interface de utilizador.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

Display

Contém as informações de apresentação localizadas para esta operação/ação específica. Estes valores serão utilizados por vários clientes para (1) definições de funções personalizadas para RBAC; (2) filtros de consulta complexos para o serviço de eventos; e (3) histórico/registos de auditoria para operações de gestão.

Name	Tipo	Description
description	string	Obtém ou define a descrição. A descrição amigável localizada da operação, tal como deve ser apresentada ao utilizador. Deve ser minucioso, mas conciso– será utilizado em sugestões de ferramentas e vistas detalhadas. Orientação prescritiva para o espaço de nomes: leia qualquer recurso "display.provider" Criar ou Atualizar qualquer recurso "display.provider" Eliminar qualquer recurso "display.provider" Efetuar qualquer outra ação em qualquer recurso "display.provider" Documentação de orientação prescritiva para o espaço de nomes: Leia qualquer "display.resource" Criar ou Atualizar qualquer "display.resource" Elimine qualquer "display.resource" "ActionName" qualquer "display.resources".
operation	string	Obtém ou define a operação. O nome amigável localizado da operação, tal como deve ser mostrado ao utilizador. Deve ser conciso (para caber em listas pendentes), mas clara (ou seja, auto-documentação). Deve utilizar a Caixa de Título. Orientação prescritiva: Leia Criar ou Atualizar Eliminar "ActionName".
provider	string	Obtém ou define o fornecedor. A forma amigável localizada do nome do fornecedor de recursos – espera-se que inclua também o editor/empresa responsável. Deve utilizar a Caixa de Título e começar com "Microsoft" para serviços originais. Por exemplo, "Microsoft Monitoring Insights" ou "Microsoft Compute".
resource	string	Obtém ou define o recurso. A forma amigável localizada do recurso relacionado com esta ação/operação – deve corresponder à documentação pública do fornecedor de recursos. Deve utilizar a Caixa de Título. Este valor deve ser exclusivo para um determinado tipo de URL (por exemplo, os tipos aninhados não devem reutilizar o campo display.resource dos respetivos principais), por exemplo, "Máquinas Virtuais" ou "Coleções de Tarefas do Scheduler", "Tamanhos de VM da Máquina Virtual" ou "Trabalhos do Scheduler".

OperationsDiscovery

Classe de deteção de operações.

Name	Tipo	Description
display	Display	Contém as informações de apresentação localizadas para esta operação/ação específica. Estes valores serão utilizados por vários clientes para (1) definições de funções personalizadas para RBAC; (2) filtros de consulta complexos para o serviço de eventos; e (3) histórico/registos de auditoria para operações de gestão.
isDataAction	boolean	Indica se a operação é uma ação de dados
name	string	Obtém ou define o Nome da API. O nome da operação que está a ser executada neste objeto específico. Deve corresponder ao nome da ação que aparece no RBAC/serviço de eventos. Exemplos de operações incluem: Microsoft.Compute/virtualMachine/capture/action Microsoft.Compute/virtualMachine/restart/action Microsoft.Compute/virtualMachine/write Microsoft.Compute/virtualMachine/read Microsoft.Compute/virtualMachine/delete Cada ação deve incluir, por ordem: (1) Hierarquia de Tipo de Espaço de Nomes do Fornecedor de Recursos (2) para a qual a ação se aplica (por exemplo, servidor/bases de dados para uma base de dados de SQL Azure) (3) Leitura, Escrita, Ação ou Eliminação que indica que tipo se aplica. Se for um PUT/PATCH numa coleção ou valor com nome, deve ser utilizada a escrita. Se for um GET, a funcionalidade Ler deve ser utilizada. Se for uma eliminação, deve ser utilizada a opção Eliminar. Se for um POST, deve ser utilizada a Ação. Como nota: todos os fornecedores de recursos teriam de incluir a operação "{Espaço de Nomes do Fornecedor de Recursos}/registar/ação" na resposta. Esta API é utilizada para se registar no respetivo serviço e deve incluir detalhes sobre a operação (por exemplo, um nome localizado para o fornecedor de recursos + quaisquer considerações especiais, como a versão PII).
origin	string	Obtém ou define a Origem. O executor pretendido da operação; governa a apresentação da operação no RBAC UX e os registos de auditoria UX. O valor predefinido é "utilizador, sistema".
properties	object	Propriedades clientDiscovery.

OperationsDiscoveryCollection

Coleção de detalhes de ClientDiscovery.

Name	Tipo	Description
nextLink	string	Obtém ou define o valor da ligação seguinte.
value	OperationsDiscovery[]	Obtém ou define os detalhes de ClientDiscovery.