Spatial Anchors Accounts - Regenerate Keys

Servicio:

Mixed Reality

Versión de la API:

2021-01-01

Nota

de retirada de Mixed Reality

El servicio Mixed Reality ya está en desuso y se retirará.

Regenerar la clave especificada de una cuenta de Spatial Anchors

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MixedReality/spatialAnchorsAccounts/{accountName}/regenerateKeys?api-version=2021-01-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Nombre de una cuenta de Mixed Reality.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Nombre de un grupo de recursos de Azure.
subscriptionId	path	True	string	Identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-00000-0000-00000-00000000000000)
api-version	query	True	string	Versión de la API que se va a usar con la solicitud HTTP.

Cuerpo de la solicitud

Nombre	Tipo	Description
serial	Serial	serial de clave que se va a regenerar

Respuestas

Nombre	Tipo	Description
200 OK	AccountKeys	De acuerdo
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	Suplantar la cuenta de usuario

Ejemplos

Regenerate spatial anchors account keys

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.MixedReality/spatialAnchorsAccounts/MyAccount/regenerateKeys?api-version=2021-01-01

{
  "serial": 1
}

Java

import com.azure.resourcemanager.mixedreality.models.AccountKeyRegenerateRequest;
import com.azure.resourcemanager.mixedreality.models.Serial;

/**
 * Samples for SpatialAnchorsAccounts RegenerateKeys.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mixedreality/resource-manager/Microsoft.MixedReality/stable/2021-01-01/examples/spatial-anchors/
     * RegenerateKey.json
     */
    /**
     * Sample code: Regenerate spatial anchors account keys.
     * 
     * @param manager Entry point to MixedRealityManager.
     */
    public static void
        regenerateSpatialAnchorsAccountKeys(com.azure.resourcemanager.mixedreality.MixedRealityManager manager) {
        manager.spatialAnchorsAccounts().regenerateKeysWithResponse("MyResourceGroup", "MyAccount",
            new AccountKeyRegenerateRequest().withSerial(Serial.ONE), 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

dotnet

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

// Generated from example definition: specification/mixedreality/resource-manager/Microsoft.MixedReality/stable/2021-01-01/examples/spatial-anchors/RegenerateKey.json
// this example is just showing the usage of "SpatialAnchorsAccounts_RegenerateKeys" 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 SpatialAnchorsAccountResource created on azure
// for more information of creating SpatialAnchorsAccountResource, please refer to the document of SpatialAnchorsAccountResource
string subscriptionId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string resourceGroupName = "MyResourceGroup";
string accountName = "MyAccount";
ResourceIdentifier spatialAnchorsAccountResourceId = SpatialAnchorsAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
SpatialAnchorsAccountResource spatialAnchorsAccount = client.GetSpatialAnchorsAccountResource(spatialAnchorsAccountResourceId);

// invoke the operation
MixedRealityAccountKeyRegenerateContent content = new MixedRealityAccountKeyRegenerateContent
{
    Serial = MixedRealityAccountKeySerial.Primary,
};
MixedRealityAccountKeys result = await spatialAnchorsAccount.RegenerateKeysAsync(content);

Console.WriteLine($"Succeeded: {result}");

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

Respuesta de muestra

status code:

200

{
  "primaryKey": "************",
  "secondaryKey": "************"
}

Definiciones

Nombre	Description
AccountKeyRegenerateRequest	Solicitud de regeneración de claves de cuenta
AccountKeys	Claves de desarrollador de la cuenta
CloudError	Respuesta de error.
CloudErrorBody	Respuesta de error de Azure.
Serial	serial de clave que se va a regenerar

AccountKeyRegenerateRequest

Object

Solicitud de regeneración de claves de cuenta

Nombre	Tipo	Valor predeterminado	Description
serial	Serial	1	serial de clave que se va a regenerar

AccountKeys

Object

Claves de desarrollador de la cuenta

Nombre	Tipo	Description
primaryKey	string	valor de la clave principal.
secondaryKey	string	valor de la clave secundaria.

CloudError

Object

Respuesta de error.

Nombre	Tipo	Description
error	CloudErrorBody	Respuesta de error.

CloudErrorBody

Object

Respuesta de error de Azure.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

Serial

Enumeración

serial de clave que se va a regenerar

Valor	Description
1	La clave principal
2	La clave secundaria