Recompilar instancias de rol vuelve a instalar el sistema operativo en instancias de roles web o roles de trabajo e inicializa los recursos de almacenamiento que usan. Si no desea inicializar los recursos de almacenamiento, puede usar Instancias de rol reimage.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/rebuild?api-version=2022-09-04
Parámetros de identificador URI
Nombre |
En |
Requerido |
Tipo |
Description |
cloudServiceName
|
path |
True
|
string
|
Nombre del servicio en la nube.
|
resourceGroupName
|
path |
True
|
string
|
Nombre del grupo de recursos.
|
subscriptionId
|
path |
True
|
string
|
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
|
api-version
|
query |
True
|
string
|
Versión de api de cliente.
|
Cuerpo de la solicitud
Nombre |
Requerido |
Tipo |
Description |
roleInstances
|
True
|
string[]
|
Lista de nombres de instancia de rol de servicio en la nube. El valor de '*' significará todas las instancias de rol del servicio en la nube.
|
Respuestas
Nombre |
Tipo |
Description |
200 OK
|
|
Aceptar
|
202 Accepted
|
|
Aceptado
|
Other Status Codes
|
CloudError
|
Error
|
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre |
Description |
user_impersonation
|
suplantación de su cuenta de usuario
|
Ejemplos
Rebuild Cloud Service Role Instances in a Cloud Service
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}/rebuild?api-version=2022-09-04
{
"roleInstances": [
"ContosoFrontend_IN_0",
"ContosoBackend_IN_1"
]
}
import com.azure.resourcemanager.compute.models.RoleInstances;
import java.util.Arrays;
/** Samples for CloudServices Rebuild. */
public final class Main {
/*
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudServiceRoleInstance_Rebuild_ByCloudService.json
*/
/**
* Sample code: Rebuild Cloud Service Role Instances in a Cloud Service.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void rebuildCloudServiceRoleInstancesInACloudService(
com.azure.resourcemanager.AzureResourceManager azure) {
azure
.virtualMachines()
.manager()
.serviceClient()
.getCloudServices()
.rebuild(
"ConstosoRG",
"{cs-name}",
new RoleInstances().withRoleInstances(Arrays.asList("ContosoFrontend_IN_0", "ContosoBackend_IN_1")),
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
package armcompute_test
import (
"context"
"log"
"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/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudServiceRoleInstance_Rebuild_ByCloudService.json
func ExampleCloudServicesClient_BeginRebuild() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewCloudServicesClient().BeginRebuild(ctx, "ConstosoRG", "{cs-name}", &armcompute.CloudServicesClientBeginRebuildOptions{Parameters: &armcompute.RoleInstances{
RoleInstances: []*string{
to.Ptr("ContosoFrontend_IN_0"),
to.Ptr("ContosoBackend_IN_1")},
},
})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
_, err = poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Rebuild Role Instances reinstalls the operating system on instances of web roles or worker roles and initializes the storage resources that are used by them. If you do not want to initialize storage resources, you can use Reimage Role Instances.
*
* @summary Rebuild Role Instances reinstalls the operating system on instances of web roles or worker roles and initializes the storage resources that are used by them. If you do not want to initialize storage resources, you can use Reimage Role Instances.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudServiceRoleInstance_Rebuild_ByCloudService.json
*/
async function rebuildCloudServiceRoleInstancesInACloudService() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "ConstosoRG";
const cloudServiceName = "{cs-name}";
const parameters = {
roleInstances: ["ContosoFrontend_IN_0", "ContosoBackend_IN_1"],
};
const options = { parameters };
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.cloudServices.beginRebuildAndWait(
resourceGroupName,
cloudServiceName,
options,
);
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.Compute;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;
// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudServiceRoleInstance_Rebuild_ByCloudService.json
// this example is just showing the usage of "CloudServices_Rebuild" 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 CloudServiceResource created on azure
// for more information of creating CloudServiceResource, please refer to the document of CloudServiceResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "ConstosoRG";
string cloudServiceName = "{cs-name}";
ResourceIdentifier cloudServiceResourceId = CloudServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, cloudServiceName);
CloudServiceResource cloudService = client.GetCloudServiceResource(cloudServiceResourceId);
// invoke the operation
RoleInstances roleInstances = new RoleInstances(new string[]
{
"ContosoFrontend_IN_0","ContosoBackend_IN_1"
});
await cloudService.RebuildAsync(WaitUntil.Completed, roleInstances: roleInstances);
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
location: https://foo.com/operationstatus
Definiciones
ApiError
Error de API.
Nombre |
Tipo |
Description |
code
|
string
|
Código de error.
|
details
|
ApiErrorBase[]
|
Detalles del error de api
|
innererror
|
InnerError
|
Error interno de api
|
message
|
string
|
El mensaje de error.
|
target
|
string
|
Destino del error concreto.
|
ApiErrorBase
Base de errores de API.
Nombre |
Tipo |
Description |
code
|
string
|
Código de error.
|
message
|
string
|
El mensaje de error.
|
target
|
string
|
Destino del error concreto.
|
CloudError
Respuesta de error del servicio Compute.
Nombre |
Tipo |
Description |
error
|
ApiError
|
Error de API.
|
InnerError
Detalles del error interno.
Nombre |
Tipo |
Description |
errordetail
|
string
|
Mensaje de error interno o volcado de memoria de excepciones.
|
exceptiontype
|
string
|
Tipo de la excepción.
|
RoleInstances
Especifica una lista de instancias de rol del servicio en la nube.
Nombre |
Tipo |
Description |
roleInstances
|
string[]
|
Lista de nombres de instancia de rol de servicio en la nube. El valor de '*' significará todas las instancias de rol del servicio en la nube.
|