Creación de un esquema de base de datos

Función

Esta API se utiliza para crear un esquema de base de datos en una instancia de base de datos especificada.

• Antes de invocar a una API, debe entender la API de Autenticación.

Restricciones

Esta operación no se puede realizar cuando la instancia de base de datos se encuentra en cualquiera de los siguientes estados: creación, cambio de clase de instancia, cambio de puerto, congelado, o anormal.

URI

• Formato de URI

  POST /v3/{project_id}/instances/{instance_id}/schema

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

  Nombre	Obligatorio	Descripción
  project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  instance_id	Sí	Especifica el ID de instancia de base de datos.

Solicitud

• Descripción de parámetro

  Tabla 2 Descripción de parámetro

  Nombre	Obligatorio	Tipo	Descripción
  db_name	Sí	String	Especifica el nombre de la base de datos. El valor contiene de 1 a 63 caracteres, incluidos letras, dígitos y guiones bajos (_). No puede comenzar con pg o un dígito, y debe ser diferente de nombres de biblioteca de plantilla de RDS for PostgreSQL. Las bibliotecas de plantillas de RDS for PostgreSQL incluyen postgres, template0, y template1.
  schemas	Sí	Array of objects	Cada elemento es la información de esquema asociada a la base de datos. Una sola solicitud admite un máximo de 20 elementos. Para obtener más información sobre la estructura del elemento, consulte Tabla 3.

  Tabla 3 descripción de estructura de datos de campo de esquemas

  Nombre	Obligatorio	Tipo	Descripción
  schema_name	Sí	String	Especifica el nombre del esquema. El valor contiene de 1 a 63 caracteres, incluidos letras, dígitos y guiones bajos (_). No puede comenzar con pg o un dígito, y debe ser diferente de RDS para los nombres de las bibliotecas de plantillas PostgreSQL y los nombres de esquema existentes. Las bibliotecas de plantillas de RDS for PostgreSQL incluyen postgres, template0, y template1. Los esquemas existentes incluyen public y information_schema.
  owner	Sí	String	Especifica el propietario de la base de datos. El valor contiene de 1 a 63 caracteres. No puede comenzar con pg o un dígito, y debe ser diferente de los nombres de usuario del sistema. Los usuarios del sistema incluyen rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy, y rdsDdm.

Solicitud de ejemplo

Creación de un esquema de base de datos

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/schema

{
    "db_name": "rds_test",
     "schemas": [
        {
            "schema_name": "teste123",
            "owner": "teste123"
        }
      ]
}

Respuesta

• Respuesta normal

  Tabla 4 Descripción de parámetro

  Nombre	Tipo	Descripción
  resp	String	Devuelve successful si la invocación es correcta.

• Ejemplo de respuesta normal

  {
      "resp": "successful"
  }

• Respuesta anormal

  Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• Normal

  200

• Anormal

  Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.