求助：使用API和PowerShell创建Azure Purview子集合是否正确？

正确的部分 #

• 使用客户端凭证流（client_credentials）进行身份验证，这是服务调用Purview API的有效方式。
• 指定根集合（testpurview）作为父集合的逻辑正确，根集合的referenceName确实与Purview账户名一致。

需要修正的问题 #

1. Token使用错误：Invoke-RestMethod的-Token参数并非用于OAuth2的Bearer Token，应改为通过Authorization请求头传递Token。
2. 缺少Content-Type头部：Purview API需要明确指定Content-Type: application/json才能正确解析JSON格式的请求体。
3. API版本过时：2019-11-01-preview是旧版预览API，建议使用稳定版如2023-05-01以避免兼容性问题。
4. JSON格式易出错：手动转义引号和换行的写法容易引发语法问题，建议将PowerShell哈希表转换为JSON，更可靠且易维护。
5. 无错误处理：脚本未验证Token是否获取成功，也未处理API返回的错误信息，不利于排查问题。

修正后的脚本 #

$tenantID = "XXXXXXXXXXXXXXXXXXXXXXX"
$clientId = "XXXXXXXXXXXXXXXXXXXXXXX"
$clientSecret = "XXXXXXXXXXXXXXXXXXXXXXXXX"

# 获取Bearer Token
$tokenParams = @{
    Uri = "https://login.microsoftonline.com/$tenantID/oauth2/token"
    Method = "Post"
    Body = @{
        client_id = $clientId
        client_secret = $clientSecret
        grant_type = "client_credentials"
        resource = "https://purview.azure.net"
    }
    UseBasicParsing = $true
}

$bearerToken = Invoke-RestMethod @tokenParams
if (-not $bearerToken.access_token) {
    Write-Error "获取Token失败"
    exit 1
}

# 配置Purview API参数
$purviewAccountName = "testpurview"
$newCollectionName = "newcollection1"
$apiVersion = "2023-05-01"
$apiUrl = "https://$purviewAccountName.purview.azure.com/account/collections/$newCollectionName?api-version=$apiVersion"

# 构造请求体
$requestBody = @{
    parentCollection = @{
        referenceName = $purviewAccountName
    }
} | ConvertTo-Json -Depth 3

# 调用API创建子集合
try {
    $response = Invoke-RestMethod -Uri $apiUrl -Method Put -Body $requestBody -ContentType "application/json" -Headers @{
        Authorization = "Bearer $($bearerToken.access_token)"
    }
    Write-Host "子集合创建成功：$($response.name)"
}
catch {
    Write-Error "创建失败：$($_.Exception.Message)"
    if ($_.ErrorDetails) {
        Write-Error "API返回详情：$($_.ErrorDetails.Message)"
    }
}

额外注意事项 #

• 确保你的服务主体（client_id对应的应用）在Purview根集合上拥有集合管理员权限，否则会因权限不足报错。
• 若需要设置子集合的其他属性（如描述），可在requestBody中添加description字段。

内容的提问来源于stack exchange，提问作者Subhransu Sekhar