Compartir a través de


Connectors - Create Or Update

Creación de un conector

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Impact/connectors/{connectorName}?api-version=2024-05-01-preview

Parámetros de identificador URI

Nombre En Requerido Tipo Description
connectorName
path True

string

pattern: ^[a-zA-Z0-9-]{3,24}$

Nombre del conector

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

api-version
query True

string

minLength: 1

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

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.connectorType True

Platform

tipo de conector

Respuestas

Nombre Tipo Description
200 OK

Connector

Operación de actualización del recurso "Connector" correcta

201 Created

Connector

La operación de creación del recurso "Connector" se realizó correctamente

Encabezados

Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

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

Connectors_CreateOrUpdate

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/74f5e23f-d4d9-410a-bb4d-8f0608adb10d/providers/Microsoft.Impact/connectors/testconnector1?api-version=2024-05-01-preview

{
  "properties": {
    "provisioningState": "Succeeded",
    "connectorType": "AzureMonitor"
  }
}

Respuesta de muestra

{
  "properties": {
    "provisioningState": "Succeeded",
    "connectorId": "430a444e-6a84-4a6f-8c50-124843ca7cd4",
    "tenantId": "23a8d1da-a7e9-4443-9797-4cd3e3aeb8f8",
    "connectorType": "AzureMonitor",
    "lastRunTimeStamp": "2024-03-19T06:23:56.238Z"
  },
  "id": "/subscriptions/74f5e23f-d4d9-410a-bb4d-8f0608adb10d/providers/Microsoft.Impact/connectors/testconnector1",
  "name": "testconnector1",
  "type": "microsoft.impact/connectors",
  "systemData": {
    "createdBy": "testuser@hotmail.com",
    "createdByType": "User",
    "createdAt": "2024-03-07T06:19:01.6431721Z",
    "lastModifiedBy": "testuser@hotmail.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-15T08:29:20.8549373Z"
  }
}
Azure-AsyncOperation: https://contoso.com/operationstatus
{
  "properties": {
    "provisioningState": "Succeeded",
    "connectorId": "430a444e-6a84-4a6f-8c50-124843ca7cd4",
    "tenantId": "23a8d1da-a7e9-4443-9797-4cd3e3aeb8f8",
    "connectorType": "AzureMonitor",
    "lastRunTimeStamp": "2024-03-19T06:23:56.238Z"
  },
  "id": "/subscriptions/74f5e23f-d4d9-410a-bb4d-8f0608adb10d/providers/Microsoft.Impact/connectors/testconnector1",
  "name": "testconnector1",
  "type": "microsoft.impact/connectors",
  "systemData": {
    "createdBy": "testuser@hotmail.com",
    "createdByType": "User",
    "createdAt": "2024-03-07T06:19:01.6431721Z",
    "lastModifiedBy": "testuser@hotmail.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-15T08:29:20.8549373Z"
  }
}

Definiciones

Nombre Description
Connector

Un conector es un recurso que se puede usar para notificar de forma proactiva los impactos en las cargas de trabajo de Azure a Microsoft.

createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

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

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

Platform

Enumeración para tipos de conectores

ProvisioningState

Estado de aprovisionamiento del recurso.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Connector

Un conector es un recurso que se puede usar para notificar de forma proactiva los impactos en las cargas de trabajo de Azure a Microsoft.

Nombre Tipo Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso

properties.connectorId

string

identificador único del conector.

properties.connectorType

Platform

tipo de conector

properties.lastRunTimeStamp

string (date-time)

Marca de tiempo de ejecución del último conector en la zona horaria UTC

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento de recursos.

properties.tenantId

string

identificador de inquilino de este conector

systemData

systemData

Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.

type

string

Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

createdByType

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

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.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

Platform

Enumeración para tipos de conectores

Valor Description
AzureMonitor

Tipo de Azure Monitor

ProvisioningState

Estado de aprovisionamiento del recurso.

Valor Description
Canceled

Aprovisionamiento cancelado

Failed

Error de aprovisionamiento

Succeeded

Aprovisionamiento correcto

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.