Compartir a través de

Resource Groups - Create Or Update

Servicio:
Resource Management
Versión de la API:
2021-04-01

Crea o actualiza un grupo de recursos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Nombre del grupo de recursos que se va a crear o actualizar. Puede incluir caracteres alfanuméricos, de subrayado, paréntesis, guiones, punto (excepto al final) y caracteres Unicode que coinciden con los caracteres permitidos.
subscriptionId
 path True

string

Identificador de suscripción de Microsoft Azure.
api-version
 query True

string

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

La ubicación del grupo de recursos. No se puede cambiar una vez creado el grupo de recursos. Debe ser una de las ubicaciones de Azure admitidas.
managedBy

string

Identificador del recurso que administra este grupo de recursos.
properties

ResourceGroupProperties

Propiedades del grupo de recursos.
tags

object

Etiquetas asociadas al grupo de recursos.

Respuestas

Nombre Tipo Description
200 OK

ResourceGroup

Aceptar: devuelve información sobre el nuevo grupo de recursos.
201 Created

ResourceGroup

Creado: devuelve información sobre el nuevo grupo de recursos.
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

Create or update a resource group

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group?api-version=2021-04-01

{
  "location": "eastus"
}

Respuesta de muestra

status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}
status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}

Definiciones

Nombre Description
CloudError

Respuesta de error para una solicitud de administración de recursos.
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorResponse

Respuesta de error
ResourceGroup

Información del grupo de recursos.
ResourceGroupProperties

Propiedades del grupo de recursos.

CloudError

Objeto

Respuesta de error para una solicitud de administración de recursos.

Nombre Tipo Description
error

ErrorResponse

Respuesta de error
Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorResponse

Objeto

Respuesta de error

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorResponse[]

Detalles del error.
message

string

Mensaje de error.
target

string

Destino del error.

ResourceGroup

Objeto

Información del grupo de recursos.

Nombre Tipo Description
id

string

Identificador del grupo de recursos.
location

string

La ubicación del grupo de recursos. No se puede cambiar una vez creado el grupo de recursos. Debe ser una de las ubicaciones de Azure admitidas.
managedBy

string

Identificador del recurso que administra este grupo de recursos.
name

string

Nombre del grupo de recursos.
properties

ResourceGroupProperties

Propiedades del grupo de recursos.
tags

object

Etiquetas asociadas al grupo de recursos.
type

string

Tipo del grupo de recursos.

ResourceGroupProperties

Objeto

Propiedades del grupo de recursos.

Nombre Tipo Description
provisioningState

string

Estado de aprovisionamiento.