Sql Agent - Create Or Update

Service:

SQL Database

Version d'API:

2023-08-01

Place la nouvelle configuration de l’agent sql à l’instance.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/sqlAgent/current?api-version=2023-08-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
managedInstanceName	path	True	string	Nom de l’instance managée.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Type	Description
properties.state	SqlAgentState	État de Sql Agent.

Réponses

Nom	Type	Description
200 OK	SqlAgentConfiguration	Mettre correctement la configuration de l’agent sql
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 400 SqlAgentManagedServerNotFound - L’utilisateur a essayé de configurer l’agent sql de l’instance managée inconnue.

Exemples

Puts new sql agent configuration to instance.

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/sqlAgent/current?api-version=2023-08-01

{
  "properties": {
    "state": "Enabled"
  }
}

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/sqlAgent/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/sqlAgent",
  "properties": {
    "state": "Enabled"
  }
}

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
SqlAgentConfiguration	Ressource de base de données managée récupérable.
SqlAgentState	État de Sql Agent.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

SqlAgentConfiguration

Objet

Ressource de base de données managée récupérable.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.state	SqlAgentState	État de Sql Agent.
type	string	Type de ressource.

SqlAgentState

Énumération

État de Sql Agent.

Valeur	Description
Enabled
Disabled