Create a project

更新时间:
复制 MD 格式

After activating the service, you can create a project using the console or an API.

Important

This document is no longer maintained. We recommend that you use the latest version of Intelligent Media Management.

Create a project in the console

To create a project in the console:

  1. Log on to the Intelligent Media Management console.

    Important

    To reduce network latency and costs, a project can only process OSS data from the same region. Select the same region as the OSS data that you want to process. You cannot change a project's region after it is created.

  2. After you select a region, on the Overview page, click Create Project.

    Note

    You can also create a project on the Project List page by clicking Create Project.

    In the Create Project dialog box, configure the following parameters: Project Name (can contain only letters, digits, and hyphens, must start with a letter, can be up to 50 characters long, and cannot be ALL), Type (for example, Content Management), Billing Method (for example, Pay-As-You-Go), QPS (the maximum number of requests processed per second, which is 10 by default; to change this value, submit a ticket), and Service Role (for example, IMMRole, which allows Intelligent Media Management to access other cloud resources such as OSS). Then, click Next.

  3. In the Create Project panel, configure the project parameters. The following table describes the parameters.

    Parameter

    Description

    Project name

    The name of the project.

    The project name must adhere to the naming conventions. You cannot change the project name after the project is created.

    Type

    The type of the project. Default value: ContentManagement.

    QPS

    The maximum number of requests that can be processed per second. The default value is 10, which cannot be changed during creation.

    A value of 10 indicates that 10 tasks, such as document format conversion or image tag detection, can be processed concurrently. Query-related API operations, such as GetImage, which retrieves image information, also consume this quota. To request higher concurrency, join the DingTalk group. For the DingTalk group number, see Contact Us.

    Service role

    The service role that allows Intelligent Media Management to access other cloud resources, such as OSS.

    When creating your first project, you must authorize cloud resource access to create the default role AliyunIMMDefaultRole. For more information, see Cloud resource access authorization.

    Warning

    Note that the AliyunIMMDefaultRole has extensive access permissions to OSS. If a RAM user has IMM permissions such as CreateProject / UpdateProject, that user can attach the AliyunIMMDefaultRole and use the metadata indexing feature to list or analyze your OSS files. To grant more granular permissions, see Create a custom service role.

  4. (Optional) Authorize access to cloud resources.

    If this is your first project, follow these steps to authorize access to cloud resources.

    1. Click Service Role.

      Note

      You can also create a service role in the RAM console. For detailed instructions, see Create a common service role.

    2. On the Cloud Resource Access Authorization page, review the information for the default service role AliyunIMMDefaultRole and click Confirm Authorization.

      After the service role is created, you can configure fine-grained permissions in the RAM console.

  5. Click Next.

  6. On the project details page, click Create Project.

    After the project is created, you can do the following on the Project List page:

    • Click a project name to view its details, service monitoring information, and more.

      • On the Details tab, view basic information about the project, such as its endpoint, supported features, and usage instructions.

      • On the Service Monitoring tab, view service monitoring data for the 100 minutes leading up to a specified point in time, filtered by time and feature. The data includes QPM, number of valid requests, service processing latency, number of client-side error requests, and number of server-side error requests.

      • On the Task Query tab, view task information by task ID to track the execution status of large files.

    • Delete a project

      In the Actions column, click Delete to delete the project.

Create a project via API

Call the PutProject operation to create a project.

Note

After you create the project, you can process documents and images. For more information, see Document format conversion and Image AI features.

You can manage the project using the following API operations:

API

Description

GetProject

Retrieves information about a project.

ListProjects

Lists all projects in a specified region.

UpdateProject

Updates the service role of a project.

DeleteProject

Deletes a project.