Delen via


Projects - Create

Maak een project van een Cognitive Services-account. Project is een subbron van een account die de AI-ontwikkelaar zijn individuele container geeft om aan te werken.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/projects/{projectName}?api-version=2025-06-01

URI-parameters

Name In Vereist Type Description
accountName
path True

string

minLength: 2
maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$

De naam van het Cognitive Services-account.

projectName
path True

string

minLength: 2
maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$

De naam van het project van het Cognitive Services-account.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string

minLength: 1

De id van het doelabonnement.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
identity

Identity

Identiteit voor de resource.

location

string

De geografische locatie waar de resource zich bevindt

properties

ProjectProperties

Eigenschappen van Cognitive Services-project.

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

Project

Als de resource is gemaakt of al bestaat, moet de service 200 (OK) retourneren.

201 Created

Project

Als de resource is gemaakt, moet de service 201 (OK) retourneren.

202 Accepted

Project

HTTP 202 (Geaccepteerd) als de bewerking is gestart en asynchroon wordt voltooid.

Other Status Codes

ErrorResponse

Foutantwoord dat beschrijft waarom de bewerking is mislukt

Voorbeelden

Create Project
Create Project Min

Create Project

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1/projects/testProject1?api-version=2025-06-01

{
  "location": "West US",
  "properties": {
    "description": "Description of this project",
    "displayName": "p1"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1/projects/testProject1",
  "name": "testProject1",
  "type": "Microsoft.CognitiveServices/accounts/projects",
  "location": "West US",
  "etag": "W/\"datetime'2017-04-10T08%3A00%3A05.445595Z'\"",
  "properties": {
    "description": "Description of this project",
    "displayName": "p1",
    "provisioningState": "Succeeded",
    "endpoints": {
      "OpenAI Language Model Instance API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Dall-E API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Sora API": "https://sub-donmain-name.openai.azure.com/"
    },
    "isDefault": true
  },
  "identity": {
    "principalId": "b5cf119e-a5c2-42c7-802f-592e0efb169f",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1/projects/testProject1",
  "name": "testProject1",
  "type": "Microsoft.CognitiveServices/accounts/projects",
  "location": "West US",
  "etag": "W/\"datetime'2017-04-10T07%3A57%3A48.4582781Z'\"",
  "properties": {
    "description": "Description of this project",
    "displayName": "p1",
    "provisioningState": "Succeeded",
    "endpoints": {
      "OpenAI Language Model Instance API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Dall-E API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Sora API": "https://sub-donmain-name.openai.azure.com/"
    },
    "isDefault": true
  },
  "identity": {
    "principalId": "b5cf119e-a5c2-42c7-802f-592e0efb169f",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1/projects/testProject1",
  "name": "testProject1",
  "type": "Microsoft.CognitiveServices/accounts/projects",
  "location": "West US",
  "etag": "W/\"datetime'2017-04-10T07%3A57%3A48.4582781Z'\"",
  "properties": {
    "description": "Description of this project",
    "displayName": "p1",
    "provisioningState": "Succeeded",
    "endpoints": {
      "OpenAI Language Model Instance API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Dall-E API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Sora API": "https://sub-donmain-name.openai.azure.com/"
    },
    "isDefault": true
  },
  "identity": {
    "principalId": "b5cf119e-a5c2-42c7-802f-592e0efb169f",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}

Create Project Min

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1/projects/testProject1?api-version=2025-06-01

{
  "location": "West US",
  "properties": {},
  "identity": {
    "type": "SystemAssigned"
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1/projects/testProject1",
  "name": "testProject1",
  "type": "Microsoft.CognitiveServices/accounts/projects",
  "location": "West US",
  "etag": "W/\"datetime'2017-04-10T08%3A00%3A05.445595Z'\"",
  "properties": {
    "provisioningState": "Succeeded",
    "endpoints": {
      "OpenAI Language Model Instance API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Dall-E API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Sora API": "https://sub-donmain-name.openai.azure.com/"
    },
    "isDefault": true
  },
  "identity": {
    "principalId": "b5cf119e-a5c2-42c7-802f-592e0efb169f",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1",
  "name": "testProject1",
  "type": "Microsoft.CognitiveServices/accounts/projects",
  "location": "West US",
  "etag": "W/\"datetime'2017-04-10T07%3A57%3A48.4582781Z'\"",
  "properties": {
    "provisioningState": "Succeeded",
    "endpoints": {
      "OpenAI Language Model Instance API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Dall-E API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Sora API": "https://sub-donmain-name.openai.azure.com/"
    },
    "isDefault": true
  },
  "identity": {
    "principalId": "b5cf119e-a5c2-42c7-802f-592e0efb169f",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/testCreate1",
  "name": "testProject1",
  "type": "Microsoft.CognitiveServices/accounts/projects",
  "location": "West US",
  "etag": "W/\"datetime'2017-04-10T07%3A57%3A48.4582781Z'\"",
  "properties": {
    "provisioningState": "Succeeded",
    "endpoints": {
      "OpenAI Language Model Instance API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Dall-E API": "https://sub-donmain-name.openai.azure.com/",
      "OpenAI Sora API": "https://sub-donmain-name.openai.azure.com/"
    },
    "isDefault": true
  },
  "identity": {
    "principalId": "b5cf119e-a5c2-42c7-802f-592e0efb169f",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

Identity

Identiteit voor de resource.

Project

Het Cognitive Services-project is een Azure-resource die het project, het type, de locatie en de SKU van het ingerichte account vertegenwoordigt.

ProjectProperties

Eigenschappen van Cognitive Services Project'.

ProvisioningState

Hiermee haalt u de status op van het account voor cognitieve services op het moment dat de bewerking werd aangeroepen.

ResourceIdentityType

Het identiteitstype.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

UserAssignedIdentity

Door de gebruiker toegewezen beheerde identiteit.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

Identity

Identiteit voor de resource.

Name Type Description
principalId

string

De hoofd-id van de resource-identiteit.

tenantId

string

De tenant-id van de resource.

type

ResourceIdentityType

Het identiteitstype.

userAssignedIdentities

<string,  UserAssignedIdentity>

De lijst met door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De belangrijkste verwijzingen naar de gebruikers-id's in de woordenlijst voor gebruikersidentiteit zijn ARM-resource-id's in de volgende vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

Project

Het Cognitive Services-project is een Azure-resource die het project, het type, de locatie en de SKU van het ingerichte account vertegenwoordigt.

Name Type Description
etag

string

Resource-Etag.

id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identity

Identiteit voor de resource.

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties

ProjectProperties

Eigenschappen van Cognitive Services-project.

systemData

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

tags

object

Resourcetags.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ProjectProperties

Eigenschappen van Cognitive Services Project'.

Name Type Description
description

string

De beschrijving van het Cognitive Services Project.

displayName

string

De weergavenaam van het Cognitive Services Project.

endpoints

object

De lijst met eindpunten voor dit Cognitive Services-project.

isDefault

boolean

Geeft aan of het project het standaardproject voor het account is.

provisioningState

ProvisioningState

Hiermee haalt u de status op van het project voor cognitieve services op het moment dat de operatie werd aangeroepen.

ProvisioningState

Hiermee haalt u de status op van het account voor cognitieve services op het moment dat de bewerking werd aangeroepen.

Waarde Description
Accepted
Creating
Deleting
Moving
Failed
Succeeded
ResolvingDNS

ResourceIdentityType

Het identiteitstype.

Waarde Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserAssignedIdentity

Door de gebruiker toegewezen beheerde identiteit.

Name Type Description
clientId

string

Client-app-id die aan deze identiteit is gekoppeld.

principalId

string

Azure Active Directory-principal-id die aan deze identiteit is gekoppeld.