Operations Discovery - Get

Dienst:

Resource Mover

API-Version:

2023-08-01

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string	Client-API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	OperationsDiscoveryCollection	Erfolg
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

OperationsDiscovery_Get

Beispielanforderung

HTTP

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

Java

/**
 * 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

Python

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

Go

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

JavaScript

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ResourceMover.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ResourceMover;

// 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);

TenantResource 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

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort des Diensts.
CloudErrorBody	Eine Fehlerantwort des Diensts.
Display	Enthält die lokalisierten Anzeigeinformationen für diesen bestimmten Vorgang/diese Aktion. Dieser Wert wird von mehreren Clients für (1) benutzerdefinierte Rollendefinitionen für RBAC verwendet; (2) komplexe Abfragefilter für den Ereignisdienst; und (3) Überwachungsverlauf /Datensätze für Verwaltungsvorgänge.
OperationsDiscovery	Operations Discovery-Klasse.
OperationsDiscoveryCollection	Sammlung von ClientDiscovery-Details.

CloudError

Objekt

Eine Fehlerantwort des Diensts.

Name	Typ	Beschreibung
error	CloudErrorBody	Cloudfehlertext.

CloudErrorBody

Objekt

Eine Fehlerantwort des Diensts.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
details	CloudErrorBody[]	Eine Liste mit zusätzlichen Details zum Fehler.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
target	string	Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

Display

Objekt

Enthält die lokalisierten Anzeigeinformationen für diesen bestimmten Vorgang/diese Aktion. Dieser Wert wird von mehreren Clients für (1) benutzerdefinierte Rollendefinitionen für RBAC verwendet; (2) komplexe Abfragefilter für den Ereignisdienst; und (3) Überwachungsverlauf /Datensätze für Verwaltungsvorgänge.

Name	Typ	Beschreibung
description	string	Ruft die Beschreibung ab oder legt sie fest. Die lokalisierte benutzerfreundliche Beschreibung für den Vorgang, wie sie dem Benutzer angezeigt werden sollte. Es sollte gründlich, aber prägnant sein – es wird in QuickInfos und detaillierten Ansichten verwendet. Präscriptive Anleitungen für Namespace: Lesen Sie eine beliebige "display.provider"-Ressource, um eine beliebige "display.provider"-Ressource zu erstellen oder zu aktualisieren. Löschen Sie eine beliebige "display.provider"-Ressource. Führen Sie eine andere Aktion für eine beliebige "display.provider"-Ressourcenbeschreibung für Namespaces durch: Lesen Sie alle "display.resource"-Ressourcen erstellen oder aktualisieren Sie alle "display.resource" "display.resource" "display.resources".
operation	string	Dient zum Abrufen oder Festlegen des Vorgangs. Der lokalisierte Anzeigename für den Vorgang, wie er dem Benutzer angezeigt werden sollte. Es sollte prägnant (in Dropdowns passen), aber klar (d. h. selbstdokumentieren). Sie sollte die Schreibweise "Titel" verwenden. Präscriptive Anleitung: Lesen Sie "ActionName" zum Erstellen oder Aktualisieren des Löschens.
provider	string	Ruft den Anbieter ab oder legt den Anbieter fest. Die lokalisierte benutzerfreundliche Form des Ressourcenanbieternamens – es wird erwartet, dass auch der Herausgeber/das Unternehmen verantwortlich ist. Sie sollte die Groß-/Kleinschreibung verwenden und mit "Microsoft" für Dienste von Drittanbietern beginnen. z. B. "Microsoft Monitoring Insights" oder "Microsoft Compute".
resource	string	Ruft die Ressource ab oder legt sie fest. Die lokalisierte benutzerfreundliche Form der Ressource im Zusammenhang mit dieser Aktion/Operation – sie sollte mit der öffentlichen Dokumentation für den Ressourcenanbieter übereinstimmen. Sie sollte die Schreibweise "Titel" verwenden. Dieser Wert sollte für einen bestimmten URL-Typ eindeutig sein (z. B. geschachtelte Typen sollten nicht das Feld "display.resource" des übergeordneten Elements wiederverwenden), z. B. "Virtuelle Computer" oder "Zeitplanauftragssammlungen", oder "VM-Größen für virtuelle Computer" oder "Planeraufträge".

OperationsDiscovery

Objekt

Operations Discovery-Klasse.

Name	Typ	Beschreibung
display	Display	Enthält die lokalisierten Anzeigeinformationen für diesen bestimmten Vorgang/diese Aktion. Dieser Wert wird von mehreren Clients für (1) benutzerdefinierte Rollendefinitionen für RBAC verwendet; (2) komplexe Abfragefilter für den Ereignisdienst; und (3) Überwachungsverlauf /Datensätze für Verwaltungsvorgänge.
isDataAction	boolean	Gibt an, ob es sich bei dem Vorgang um eine Datenaktion handelt.
name	string	Dient zum Abrufen oder Festlegen des Namens der API. Der Name des Vorgangs, der für dieses bestimmte Objekt ausgeführt wird. Er sollte mit dem Aktionsnamen übereinstimmen, der in RBAC /dem Ereignisdienst angezeigt wird. Beispiele für Vorgänge sind: Microsoft.Compute/virtualMachine/capture/action Microsoft.Compute/virtualMachine/restart/action Microsoft.Compute/virtualMachine/write Microsoft.Compute/virtualMachine/read Microsoft.Compute/virtualMachine/delete Jede Aktion sollte folgendes enthalten: (1) Ressourcenanbieternamespace (2) Typhierarchie, für die die Aktion gilt (z. B. Server/Datenbanken für eine SQL Azure-Datenbank) (3) Lese-, Schreib-, Aktions- oder Delete-Wert, der angibt, welcher Typ gilt. Wenn es sich um einen PUT/PATCH für eine Auflistung oder einen benannten Wert handelt, sollte Write verwendet werden. Wenn es sich um einen GET handelt, sollte Read verwendet werden. Wenn es sich um eine DELETE-Datei handelt, sollte "Delete" verwendet werden. Wenn es sich um einen POST handelt, sollte die Aktion verwendet werden. Hinweis: Alle Ressourcenanbieter müssten den Vorgang "{Resource Provider Namespace}/register/action" in ihre Antwort einschließen. Diese API wird verwendet, um sich für ihren Dienst zu registrieren und sollte Details zum Vorgang enthalten (z. B. einen lokalisierten Namen für den Ressourcenanbieter und alle besonderen Aspekte wie die PII-Veröffentlichung).
origin	string	Dient zum Abrufen oder Festlegen von Origin. Der beabsichtigte Ausführungsführer des Vorgangs; steuert die Anzeige des Vorgangs in der RBAC-UX und der Überwachungsprotokoll-UX. Der Standardwert ist "user,system".
properties	object	ClientDiscovery-Eigenschaften.

OperationsDiscoveryCollection

Objekt

Sammlung von ClientDiscovery-Details.

Name	Typ	Beschreibung
nextLink	string	Dient zum Abrufen oder Festlegen des Werts des nächsten Links.
value	OperationsDiscovery[]	Ruft die ClientDiscovery-Details ab oder legt diese fest.