Compartir a través de

Items - Create Warehouse

  • Referencia
Servicio:
Warehouse
Versión de la API:
v1

Crea un almacén en el área de trabajo especificada.
Esta API admite operaciones de larga duración (LRO).

Esta API no admite la creación de un almacén con definición.

Permisos

El autor de la llamada debe tener rol de colaborador o superior.

Ámbitos delegados necesarios

Warehouse.ReadWrite.All o Item.ReadWrite.All

Limitaciones

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identidad Apoyo
Usuario Sí
de entidad de servicio y identidades administradas Sí

Interfaz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses

Parámetros de identificador URI

Nombre En Requerido Tipo Description
workspaceId
 path True

string

uuid

Identificador del área de trabajo.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
displayName True

string

Nombre para mostrar del almacén. El nombre para mostrar debe seguir las reglas de nomenclatura según el tipo de elemento.
creationPayload

WarehouseCreationPayload

Carga de creación del almacenamiento. Use creationPayload. No puede usar definition ni creationPayload al mismo tiempo.
description

string

Descripción del almacén. La longitud máxima es de 256 caracteres.

Respuestas

Nombre Tipo Description
201 Created

Warehouse

Creado correctamente
202 Accepted

Solicitud aceptada, aprovisionamiento de almacenamiento en curso.

Encabezados

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • InvalidItemType: el tipo de elemento no es válido.

  • ItemDisplayNameAlreadyInUse: ya se usa el nombre para mostrar del elemento.

  • CorruptedPayload: la carga proporcionada está dañada.

Ejemplos

Create a warehouse example
Create a warehouse example with payload

Create a warehouse example

Solicitud de ejemplo

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description."
}

Respuesta de muestra

status code:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
status code:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a warehouse example with payload

Solicitud de ejemplo

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses

{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "creationPayload": {
    "collationType": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8"
  }
}

Respuesta de muestra

status code:
201 
{
  "displayName": "Warehouse 1",
  "description": "A warehouse description.",
  "type": "Warehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
status code:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definiciones

Nombre Description
CollationType

Intercalación de almacenamiento. Se pueden agregar collations adicionales a lo largo del tiempo.
CreateWarehouseRequest

Cree una carga de solicitud de almacenamiento.
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.
ItemType

Tipo del elemento. Se pueden agregar tipos de elementos adicionales a lo largo del tiempo.
Warehouse

Objeto de almacenamiento.
WarehouseCreationPayload

Carga del elemento de almacenamiento
WarehouseProperties

Propiedades del elemento de almacenamiento.

CollationType

Enumeración

Intercalación de almacenamiento. Se pueden agregar collations adicionales a lo largo del tiempo.

Valor Description
Latin1_General_100_BIN2_UTF8

Valor predeterminado: intercalación con distinción entre mayúsculas y minúsculas (CS)
Latin1_General_100_CI_AS_KS_WS_SC_UTF8

Intercalación sin distinción entre mayúsculas y minúsculas (CI)

CreateWarehouseRequest

Object

Cree una carga de solicitud de almacenamiento.

Nombre Tipo Description
creationPayload

WarehouseCreationPayload

Carga de creación del almacenamiento. Use creationPayload. No puede usar definition ni creationPayload al mismo tiempo.
description

string

Descripción del almacén. La longitud máxima es de 256 caracteres.
displayName

string

Nombre para mostrar del almacén. El nombre para mostrar debe seguir las reglas de nomenclatura según el tipo de elemento.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.

ItemType

Enumeración

Tipo del elemento. Se pueden agregar tipos de elementos adicionales a lo largo del tiempo.

Valor Description
Dashboard

Panel de PowerBI.
DataPipeline

Una canalización de datos.
Datamart

Datamart de PowerBI.
Environment

Un entorno.
Eventhouse

Un centro de eventos.
Eventstream

Una secuencia de eventos.
GraphQLApi

Una API para el elemento GraphQL.
KQLDashboard

Un panel de KQL.
KQLDatabase

Una base de datos KQL.
KQLQueryset

Un conjunto de consultas KQL.
Lakehouse

Una casa de lago.
MLExperiment

Un experimento de aprendizaje automático.
MLModel

Un modelo de aprendizaje automático.
MirroredDatabase

Una base de datos reflejada.
MirroredWarehouse

Un almacén reflejado.
MountedDataFactory

A MountedDataFactory.
Notebook

Un cuaderno.
PaginatedReport

Informe paginado de PowerBI.
Reflex

Un reflejo.
Report

Informe de PowerBI.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Un punto de conexión de SQL.
SemanticModel

Modelo semántico de PowerBI.
SparkJobDefinition

Una definición de trabajo de Spark.
Warehouse

Un almacén.

Warehouse

Object

Objeto de almacenamiento.

Nombre Tipo Description
description

string

Descripción del elemento.
displayName

string

Nombre para mostrar del elemento.
id

string

uuid

Identificador del elemento.
properties

WarehouseProperties

Las propiedades del almacén.
type

ItemType

Tipo de elemento.
workspaceId

string

uuid

Identificador del área de trabajo.

WarehouseCreationPayload

Object

Carga del elemento de almacenamiento

Nombre Tipo Description
collationType

CollationType

Tipo de intercalación predeterminado del almacén.

WarehouseProperties

Object

Propiedades del elemento de almacenamiento.

Nombre Tipo Description
collationType

CollationType

Tipo de intercalación del almacén.
connectionString

string

Cadena de conexión SQL conectada al área de trabajo que contiene este almacenamiento.
createdDate

string

date-time

Fecha y hora en que se creó el almacén.
lastUpdatedTime

string

date-time

Fecha y hora en que se actualizó por última vez el almacén