Creación de una base de datos de Azure SQL mediante la API REST

Artículo
05/08/2023

En este procedimiento se muestra cómo crear una base de datos de Azure SQL mediante la API REST de Azure.

La documentación de referencia completa y los ejemplos adicionales están disponibles en la referencia de REST de Azure SQL Database.

Compilar la solicitud

Use la siguiente solicitud HTTP PUT para crear una nueva base de datos de Azure SQL.

HTTP

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2017-10-01-preview

Encabezados de solicitud

Los siguientes encabezados son obligatorios:

Encabezado de solicitud	Descripción
Content-Type:	Necesario. Establézcalo en `application/json`.
Authorization:	Necesario. Establézcalo en un token de acceso`Bearer` válido.

Parámetros del identificador URI

Nombre	Descripción
subscriptionId	El id. de suscripción que identifica una suscripción de Azure. Si tiene varias suscripciones, consulte Trabajo con varias suscripciones.
resourceGroupName	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API de Azure Resource Manager, la CLI o en Azure Portal.
serverName	Nombre del servidor de base de datos de Azure SQL.
databaseName	El nombre de la base de datos.
api-version	La versión de API que se usará para la solicitud. En este documento se describe la versión `2017-10-01-preview` de la API que se incluye en la dirección URL anterior.

Cuerpo de la solicitud

El único parámetro necesario es location. Use parámetros opcionales para personalizar la base de datos.

Nombre	Tipo	Descripción
ubicación	string	Ubicación del recurso Obtenga una lista actualizada de ubicaciones mediante la operación Enumerar ubicaciones operación.

Control de la respuesta

El código de estado 201 se devuelve al crear correctamente la base de datos. Hay disponible una lista completa de códigos de respuesta, incluidos los códigos de error, en la documentación de referencia.

Respuesta de ejemplo

JSON

{
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Compartir a través de