scaleway.ipfs.v1alpha1 package

Submodules

scaleway.ipfs.v1alpha1.api module

class scaleway.ipfs.v1alpha1.api.IpfsV1Alpha1API(client: Client, *, bypass_validation: bool = False)

Bases: API

IPFS Pinning service API.

create_pin_by_cid(*, volume_id: str, cid: str, region: str | None = None, origins: List[str] | None = None, name: str | None = None) → Pin

Create a pin by CID. Will fetch and store the content pointed by the provided CID. The content must be available on the public IPFS network. The content (IPFS blocks) will be host by the pinning service until pin deletion. From that point, any other IPFS peer can fetch and host your content: Make sure to pin public or encrypted content. Many pin requests (from different users) can target the same CID. A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID. :param volume_id: Volume ID on which you want to pin your content. :param cid: CID containing the content you want to pin. :param region: Region to target. If none is passed will use default region from the config. :param origins: Node containing the content you want to pin. :param name: Pin name. :return: Pin

Usage:

result = api.create_pin_by_cid(
    volume_id="example",
    cid="example",
)

create_pin_by_url(*, volume_id: str, url: str, region: str | None = None, name: str | None = None) → Pin

Create a pin by URL. Will fetch and store the content pointed by the provided URL. The content must be available on the public IPFS network. The content (IPFS blocks) will be host by the pinning service until pin deletion. From that point, any other IPFS peer can fetch and host your content: Make sure to pin public or encrypted content. Many pin requests (from different users) can target the same CID. A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID. :param volume_id: Volume ID on which you want to pin your content. :param url: URL containing the content you want to pin. :param region: Region to target. If none is passed will use default region from the config. :param name: Pin name. :return: Pin

Usage:

result = api.create_pin_by_url(
    volume_id="example",
    url="example",
)

create_volume(*, name: str, region: str | None = None, project_id: str | None = None) → Volume

Create a new volume. Create a new volume from a Project ID. Volume is identified by an ID and used to host pin references. Volume is personal (at least to your organization) even if IPFS blocks and CID are available to anyone. Should be the first command you made because every pin must be attached to a volume. :param name: Volume name. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :return: Volume

Usage:

result = api.create_volume(
    name="example",
)

delete_pin(*, volume_id: str, pin_id: str, region: str | None = None) → None

Create an unpin request. An unpin request means that you no longer own the content. This content can therefore be removed and no longer provided on the IPFS network. :param volume_id: Volume ID. :param pin_id: Pin ID you want to remove from the volume. :param region: Region to target. If none is passed will use default region from the config.

Usage:

result = api.delete_pin(
    volume_id="example",
    pin_id="example",
)

delete_volume(*, volume_id: str, region: str | None = None) → None

Delete an existing volume. Delete a volume by its ID and every pin attached to this volume. This process can take a while to conclude, depending on the size of your pinned content. :param volume_id: Volume ID. :param region: Region to target. If none is passed will use default region from the config.

Usage:

result = api.delete_volume(
    volume_id="example",
)

get_pin(*, volume_id: str, pin_id: str, region: str | None = None) → Pin

Get pin information. Retrieve information about the provided pin ID, such as status, last modification, and CID. :param volume_id: Volume ID. :param pin_id: Pin ID of which you want to obtain information. :param region: Region to target. If none is passed will use default region from the config. :return: Pin

Usage:

result = api.get_pin(
    volume_id="example",
    pin_id="example",
)

get_volume(*, volume_id: str, region: str | None = None) → Volume

Get information about a volume. Retrieve information about a specific volume. :param volume_id: Volume ID. :param region: Region to target. If none is passed will use default region from the config. :return: Volume

Usage:

result = api.get_volume(
    volume_id="example",
)

List all pins within a volume. Retrieve information about all pins within a volume. :param volume_id: Volume ID of which you want to list the pins. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort order of the returned Volume. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :param status: List pins by status. :return: ListPinsResponse

Usage:

result = api.list_pins(
    volume_id="example",
)

List all pins within a volume. Retrieve information about all pins within a volume. :param volume_id: Volume ID of which you want to list the pins. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort order of the returned Volume. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :param status: List pins by status. :return: List[Pin]

Usage:

result = api.list_pins_all(
    volume_id="example",
)

List all volumes by a Project ID. Retrieve information about all volumes from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID, only volumes belonging to this project will be listed. :param order_by: Sort the order of the returned volumes. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :return: ListVolumesResponse

Usage:

result = api.list_volumes()

List all volumes by a Project ID. Retrieve information about all volumes from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID, only volumes belonging to this project will be listed. :param order_by: Sort the order of the returned volumes. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :return: List[Volume]

Usage:

result = api.list_volumes_all()

replace_pin(*, volume_id: str, pin_id: str, cid: str, region: str | None = None, name: str | None = None, origins: List[str] | None = None) → ReplacePinResponse

Replace pin by CID. Deletes the given resource ID and pins the new CID in its place. Will fetch and store the content pointed by the provided CID. The content must be available on the public IPFS network. The content (IPFS blocks) is hosted by the pinning service until the pin is deleted. While the content is available any other IPFS peer can fetch and host your content. For this reason, we recommend that you pin either public or encrypted content. Several different pin requests can target the same CID. A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID. :param volume_id: Volume ID. :param pin_id: Pin ID whose information you wish to replace. :param cid: New CID you want to pin in place of the old one. :param region: Region to target. If none is passed will use default region from the config. :param name: New name to replace. :param origins: Node containing the content you want to pin. :return: ReplacePinResponse

Usage:

result = api.replace_pin(
    volume_id="example",
    pin_id="example",
    cid="example",
)

update_volume(*, volume_id: str, region: str | None = None, name: str | None = None, tags: List[str] | None = None) → Volume

Update volume information. Update volume information (tag, name…). :param volume_id: Volume ID. :param region: Region to target. If none is passed will use default region from the config. :param name: Volume name. :param tags: Tags of the volume. :return: Volume

Usage:

result = api.update_volume(
    volume_id="example",
)

wait_for_pin(*, volume_id: str, pin_id: str, region: str | None = None, options: WaitForOptions[Pin, bool] | None = None) → Pin

Get pin information. Retrieve information about the provided pin ID, such as status, last modification, and CID. :param volume_id: Volume ID. :param pin_id: Pin ID of which you want to obtain information. :param region: Region to target. If none is passed will use default region from the config. :return: Pin

Usage:

result = api.get_pin(
    volume_id="example",
    pin_id="example",
)

class scaleway.ipfs.v1alpha1.api.IpfsV1Alpha1IpnsAPI(client: Client, *, bypass_validation: bool = False)

Bases: API

create_name(*, name: str, value: str, region: str | None = None, project_id: str | None = None) → Name

Create a new name. You can use the ipns key command to list and generate more names and their respective keys. :param name: Name for your records. :param value: Value you want to associate with your records, CID or IPNS key. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :return: Name

Usage:

result = api.create_name(
    name="example",
    value="example",
)

delete_name(*, name_id: str, region: str | None = None) → None

Delete an existing name. Delete a name by its ID. :param name_id: Name ID you wish to delete. :param region: Region to target. If none is passed will use default region from the config.

Usage:

result = api.delete_name(
    name_id="example",
)

export_key_name(*, name_id: str, region: str | None = None) → ExportKeyNameResponse

Export your private key. Export a private key by its ID. :param name_id: Name ID whose keys you want to export. :param region: Region to target. If none is passed will use default region from the config. :return: ExportKeyNameResponse

Usage:

result = api.export_key_name(
    name_id="example",
)

get_name(*, name_id: str, region: str | None = None) → Name

Get information about a name. Retrieve information about a specific name. :param name_id: Name ID whose information you want to retrieve. :param region: Region to target. If none is passed will use default region from the config. :return: Name

Usage:

result = api.get_name(
    name_id="example",
)

import_key_name(*, name: str, private_key: str, value: str, region: str | None = None, project_id: str | None = None) → Name

Import your private key. Import a private key. :param name: Name for your records. :param private_key: Base64 private key. :param value: Value you want to associate with your records, CID or IPNS key. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :return: Name

Usage:

result = api.import_key_name(
    name="example",
    private_key="example",
    value="example",
)

List all names by a Project ID. Retrieve information about all names from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort the order of the returned names. :param page: Page number. :param page_size: Maximum number of names to return per page. :return: ListNamesResponse

Usage:

result = api.list_names()

List all names by a Project ID. Retrieve information about all names from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort the order of the returned names. :param page: Page number. :param page_size: Maximum number of names to return per page. :return: List[Name]

Usage:

result = api.list_names_all()

update_name(*, name_id: str, region: str | None = None, name: str | None = None, tags: List[str] | None = None, value: str | None = None) → Name

Update name information. Update name information (CID, tag, name…). :param name_id: Name ID you wish to update. :param region: Region to target. If none is passed will use default region from the config. :param name: New name you want to associate with your record. :param tags: New tags you want to associate with your record. :param value: Value you want to associate with your records, CID or IPNS key. :return: Name

Usage:

result = api.update_name(
    name_id="example",
)

wait_for_name(*, name_id: str, region: str | None = None, options: WaitForOptions[Name, bool] | None = None) → Name

Get information about a name. Retrieve information about a specific name. :param name_id: Name ID whose information you want to retrieve. :param region: Region to target. If none is passed will use default region from the config. :return: Name

Usage:

result = api.get_name(
    name_id="example",
)

scaleway.ipfs.v1alpha1.content module

scaleway.ipfs.v1alpha1.content.NAME_TRANSIENT_STATUSES: List[NameStatus] = [<NameStatus.QUEUED: 'queued'>, <NameStatus.PUBLISHING: 'publishing'>]: Lists transient statutes of the enum NameStatus.

scaleway.ipfs.v1alpha1.content.PIN_TRANSIENT_STATUSES: List[PinStatus] = [<PinStatus.QUEUED: 'queued'>, <PinStatus.PINNING: 'pinning'>]: Lists transient statutes of the enum PinStatus.

scaleway.ipfs.v1alpha1.marshalling module

scaleway.ipfs.v1alpha1.marshalling.marshal_CreatePinByCIDRequest(request: CreatePinByCIDRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_CreatePinByURLRequest(request: CreatePinByURLRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_CreateVolumeRequest(request: CreateVolumeRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_IpnsApiCreateNameRequest(request: IpnsApiCreateNameRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_IpnsApiImportKeyNameRequest(request: IpnsApiImportKeyNameRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_IpnsApiUpdateNameRequest(request: IpnsApiUpdateNameRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_ReplacePinRequest(request: ReplacePinRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.marshal_UpdateVolumeRequest(request: UpdateVolumeRequest, defaults: ProfileDefaults) → Dict[str, Any]

scaleway.ipfs.v1alpha1.marshalling.unmarshal_ExportKeyNameResponse(data: Any) → ExportKeyNameResponse

scaleway.ipfs.v1alpha1.marshalling.unmarshal_ListNamesResponse(data: Any) → ListNamesResponse

scaleway.ipfs.v1alpha1.marshalling.unmarshal_ListPinsResponse(data: Any) → ListPinsResponse

scaleway.ipfs.v1alpha1.marshalling.unmarshal_ListVolumesResponse(data: Any) → ListVolumesResponse

scaleway.ipfs.v1alpha1.marshalling.unmarshal_Name(data: Any) → Name

scaleway.ipfs.v1alpha1.marshalling.unmarshal_Pin(data: Any) → Pin

scaleway.ipfs.v1alpha1.marshalling.unmarshal_PinCID(data: Any) → PinCID

scaleway.ipfs.v1alpha1.marshalling.unmarshal_PinCIDMeta(data: Any) → PinCIDMeta

scaleway.ipfs.v1alpha1.marshalling.unmarshal_PinInfo(data: Any) → PinInfo

scaleway.ipfs.v1alpha1.marshalling.unmarshal_ReplacePinResponse(data: Any) → ReplacePinResponse

scaleway.ipfs.v1alpha1.marshalling.unmarshal_Volume(data: Any) → Volume

scaleway.ipfs.v1alpha1.types module

class scaleway.ipfs.v1alpha1.types.CreatePinByCIDRequest(volume_id: 'str', cid: 'str', region: 'Optional[Region]', origins: 'Optional[List[str]]', name: 'Optional[str]')

Bases: object

cid: str: CID containing the content you want to pin.

name: str | None: Pin name.

origins: List[str] | None: Node containing the content you want to pin.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID on which you want to pin your content.

class scaleway.ipfs.v1alpha1.types.CreatePinByURLRequest(volume_id: 'str', url: 'str', region: 'Optional[Region]', name: 'Optional[str]')

Bases: object

name: str | None: Pin name.

region: str | None: Region to target. If none is passed will use default region from the config.

url: str: URL containing the content you want to pin.

volume_id: str: Volume ID on which you want to pin your content.

class scaleway.ipfs.v1alpha1.types.CreateVolumeRequest(name: 'str', region: 'Optional[Region]', project_id: 'Optional[str]')

Bases: object

name: str: Volume name.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.types.DeletePinRequest(volume_id: 'str', pin_id: 'str', region: 'Optional[Region]')

Bases: object

pin_id: str: Pin ID you want to remove from the volume.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.types.DeleteVolumeRequest(volume_id: 'str', region: 'Optional[Region]')

Bases: object

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.types.ExportKeyNameResponse(name_id: 'str', project_id: 'str', public_key: 'str', private_key: 'str', created_at: 'Optional[datetime]', updated_at: 'Optional[datetime]')

Bases: object

created_at: datetime | None

name_id: str

private_key: str

project_id: str

public_key: str

updated_at: datetime | None

class scaleway.ipfs.v1alpha1.types.GetPinRequest(volume_id: 'str', pin_id: 'str', region: 'Optional[Region]')

Bases: object

pin_id: str: Pin ID of which you want to obtain information.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.types.GetVolumeRequest(volume_id: 'str', region: 'Optional[Region]')

Bases: object

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.types.IpnsApiCreateNameRequest(name: 'str', value: 'str', region: 'Optional[Region]', project_id: 'Optional[str]')

Bases: object

name: str: Name for your records.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

value: str: Value you want to associate with your records, CID or IPNS key.

class scaleway.ipfs.v1alpha1.types.IpnsApiDeleteNameRequest(name_id: 'str', region: 'Optional[Region]')

Bases: object

name_id: str: Name ID you wish to delete.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.types.IpnsApiExportKeyNameRequest(name_id: 'str', region: 'Optional[Region]')

Bases: object

name_id: str: Name ID whose keys you want to export.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.types.IpnsApiGetNameRequest(name_id: 'str', region: 'Optional[Region]')

Bases: object

name_id: str: Name ID whose information you want to retrieve.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.types.IpnsApiImportKeyNameRequest(name: 'str', private_key: 'str', value: 'str', region: 'Optional[Region]', project_id: 'Optional[str]')

Bases: object

name: str: Name for your records.

private_key: str: Base64 private key.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

value: str: Value you want to associate with your records, CID or IPNS key.

class scaleway.ipfs.v1alpha1.types.IpnsApiListNamesRequest(region: 'Optional[Region]', project_id: 'Optional[str]', organization_id: 'Optional[str]', order_by: 'Optional[ListNamesRequestOrderBy]', page: 'Optional[int]', page_size: 'Optional[int]')

Bases: object

order_by: ListNamesRequestOrderBy | None: Sort the order of the returned names.

organization_id: str | None: Organization ID.

page: int | None: Page number.

page_size: int | None: Maximum number of names to return per page.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.types.IpnsApiUpdateNameRequest(name_id: 'str', region: 'Optional[Region]', name: 'Optional[str]', tags: 'Optional[List[str]]', value: 'Optional[str]')

Bases: object

name: str | None: New name you want to associate with your record.

name_id: str: Name ID you wish to update.

region: str | None: Region to target. If none is passed will use default region from the config.

tags: List[str] | None: New tags you want to associate with your record.

value: str | None: Value you want to associate with your records, CID or IPNS key.

class scaleway.ipfs.v1alpha1.types.ListNamesRequestOrderBy(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CREATED_AT_ASC = 'created_at_asc'

CREATED_AT_DESC = 'created_at_desc'

class scaleway.ipfs.v1alpha1.types.ListNamesResponse(names: 'List[Name]', total_count: 'int')

Bases: object

names: List[Name]

total_count: int

class scaleway.ipfs.v1alpha1.types.ListPinsRequest(volume_id: 'str', region: 'Optional[Region]', project_id: 'Optional[str]', organization_id: 'Optional[str]', order_by: 'Optional[ListPinsRequestOrderBy]', page: 'Optional[int]', page_size: 'Optional[int]', status: 'Optional[PinStatus]')

Bases: object

order_by: ListPinsRequestOrderBy | None: Sort order of the returned Volume.

organization_id: str | None: Organization ID.

page: int | None: Page number.

page_size: int | None: Maximum number of volumes to return per page.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

status: PinStatus | None: List pins by status.

volume_id: str: Volume ID of which you want to list the pins.

class scaleway.ipfs.v1alpha1.types.ListPinsRequestOrderBy(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CREATED_AT_ASC = 'created_at_asc'

CREATED_AT_DESC = 'created_at_desc'

class scaleway.ipfs.v1alpha1.types.ListPinsResponse(total_count: 'int', pins: 'List[Pin]')

Bases: object

pins: List[Pin]

total_count: int

class scaleway.ipfs.v1alpha1.types.ListVolumesRequest(region: 'Optional[Region]', project_id: 'Optional[str]', order_by: 'Optional[ListVolumesRequestOrderBy]', page: 'Optional[int]', page_size: 'Optional[int]')

Bases: object

order_by: ListVolumesRequestOrderBy | None: Sort the order of the returned volumes.

page: int | None: Page number.

page_size: int | None: Maximum number of volumes to return per page.

project_id: str | None: Project ID, only volumes belonging to this project will be listed.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.types.ListVolumesRequestOrderBy(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CREATED_AT_ASC = 'created_at_asc'

CREATED_AT_DESC = 'created_at_desc'

class scaleway.ipfs.v1alpha1.types.ListVolumesResponse(volumes: 'List[Volume]', total_count: 'int')

Bases: object

total_count: int

volumes: List[Volume]

class scaleway.ipfs.v1alpha1.types.Name(name_id: 'str', project_id: 'str', tags: 'List[str]', name: 'str', key: 'str', status: 'NameStatus', value: 'str', region: 'Region', created_at: 'Optional[datetime]', updated_at: 'Optional[datetime]')

Bases: object

created_at: datetime | None

key: str

name: str

name_id: str

project_id: str

region: str: Region to target. If none is passed will use default region from the config.

status: NameStatus

tags: List[str]

updated_at: datetime | None

value: str

class scaleway.ipfs.v1alpha1.types.NameStatus(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

FAILED = 'failed'

PUBLISHED = 'published'

PUBLISHING = 'publishing'

QUEUED = 'queued'

UNKNOWN_STATUS = 'unknown_status'

class scaleway.ipfs.v1alpha1.types.Pin(pin_id: 'str', status: 'PinStatus', delegates: 'List[str]', created_at: 'Optional[datetime]', cid: 'Optional[PinCID]', info: 'Optional[PinInfo]')

Bases: object

cid: PinCID | None

created_at: datetime | None

delegates: List[str]

info: PinInfo | None

pin_id: str

status: PinStatus

class scaleway.ipfs.v1alpha1.types.PinCID(origins: 'List[str]', cid: 'Optional[str]', name: 'Optional[str]', meta: 'Optional[PinCIDMeta]')

Bases: object

cid: str | None

meta: PinCIDMeta | None

name: str | None

origins: List[str]

class scaleway.ipfs.v1alpha1.types.PinCIDMeta(id: 'Optional[str]')

Bases: object

id: str | None

class scaleway.ipfs.v1alpha1.types.PinDetails(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CHECKING_COHERENCE = 'checking_coherence'

FAILED_CONTAINS_BANNED_CID = 'failed_contains_banned_cid'

FAILED_PINNING = 'failed_pinning'

FAILED_PINNING_BAD_CID_FORMAT = 'failed_pinning_bad_cid_format'

FAILED_PINNING_BAD_URL_FORMAT = 'failed_pinning_bad_url_format'

FAILED_PINNING_BAD_URL_STATUS_CODE = 'failed_pinning_bad_url_status_code'

FAILED_PINNING_NO_PROVIDER = 'failed_pinning_no_provider'

FAILED_PINNING_NO_URL_CONTENT_LENGTH = 'failed_pinning_no_url_content_length'

FAILED_PINNING_TIMEOUT = 'failed_pinning_timeout'

FAILED_PINNING_TOO_BIG_CONTENT = 'failed_pinning_too_big_content'

FAILED_PINNING_UNREACHABLE_URL = 'failed_pinning_unreachable_url'

FAILED_UNPINNING = 'failed_unpinning'

PINNED_OK = 'pinned_ok'

PINNING_BLOCKS_FETCHED = 'pinning_blocks_fetched'

PINNING_FETCHING_URL_DATA = 'pinning_fetching_url_data'

PINNING_IN_PROGRESS = 'pinning_in_progress'

PINNING_LOOKING_FOR_PROVIDER = 'pinning_looking_for_provider'

RESCHEDULED = 'rescheduled'

UNKNOWN_DETAILS = 'unknown_details'

UNPINNED_OK = 'unpinned_ok'

UNPINNING_IN_PROGRESS = 'unpinning_in_progress'

class scaleway.ipfs.v1alpha1.types.PinInfo(status_details: 'PinDetails', id: 'Optional[str]', url: 'Optional[str]', size: 'Optional[int]', progress: 'Optional[int]')

Bases: object

id: str | None

progress: int | None

size: int | None

status_details: PinDetails

url: str | None

class scaleway.ipfs.v1alpha1.types.PinStatus(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

FAILED = 'failed'

PINNED = 'pinned'

PINNING = 'pinning'

QUEUED = 'queued'

UNKNOWN_STATUS = 'unknown_status'

class scaleway.ipfs.v1alpha1.types.ReplacePinRequest(volume_id: 'str', pin_id: 'str', cid: 'str', region: 'Optional[Region]', name: 'Optional[str]', origins: 'Optional[List[str]]')

Bases: object

cid: str: New CID you want to pin in place of the old one.

name: str | None: New name to replace.

origins: List[str] | None: Node containing the content you want to pin.

pin_id: str: Pin ID whose information you wish to replace.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.types.ReplacePinResponse(pin: 'Optional[Pin]')

Bases: object

pin: Pin | None

class scaleway.ipfs.v1alpha1.types.UpdateVolumeRequest(volume_id: 'str', region: 'Optional[Region]', name: 'Optional[str]', tags: 'Optional[List[str]]')

Bases: object

name: str | None: Volume name.

region: str | None: Region to target. If none is passed will use default region from the config.

tags: List[str] | None: Tags of the volume.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.types.Volume(id: 'str', project_id: 'str', region: 'Region', count_pin: 'int', tags: 'List[str]', name: 'str', created_at: 'Optional[datetime]', updated_at: 'Optional[datetime]', size: 'Optional[int]')

Bases: object

count_pin: int

created_at: datetime | None

id: str

name: str

project_id: str

region: str: Region to target. If none is passed will use default region from the config.

size: int | None

tags: List[str]

updated_at: datetime | None

Module contents

class scaleway.ipfs.v1alpha1.CreatePinByCIDRequest(volume_id: 'str', cid: 'str', region: 'Optional[Region]', origins: 'Optional[List[str]]', name: 'Optional[str]')

Bases: object

cid: str: CID containing the content you want to pin.

name: str | None: Pin name.

origins: List[str] | None: Node containing the content you want to pin.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID on which you want to pin your content.

class scaleway.ipfs.v1alpha1.CreatePinByURLRequest(volume_id: 'str', url: 'str', region: 'Optional[Region]', name: 'Optional[str]')

Bases: object

name: str | None: Pin name.

region: str | None: Region to target. If none is passed will use default region from the config.

url: str: URL containing the content you want to pin.

volume_id: str: Volume ID on which you want to pin your content.

class scaleway.ipfs.v1alpha1.CreateVolumeRequest(name: 'str', region: 'Optional[Region]', project_id: 'Optional[str]')

Bases: object

name: str: Volume name.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.DeletePinRequest(volume_id: 'str', pin_id: 'str', region: 'Optional[Region]')

Bases: object

pin_id: str: Pin ID you want to remove from the volume.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.DeleteVolumeRequest(volume_id: 'str', region: 'Optional[Region]')

Bases: object

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.ExportKeyNameResponse(name_id: 'str', project_id: 'str', public_key: 'str', private_key: 'str', created_at: 'Optional[datetime]', updated_at: 'Optional[datetime]')

Bases: object

created_at: datetime | None

name_id: str

private_key: str

project_id: str

public_key: str

updated_at: datetime | None

class scaleway.ipfs.v1alpha1.GetPinRequest(volume_id: 'str', pin_id: 'str', region: 'Optional[Region]')

Bases: object

pin_id: str: Pin ID of which you want to obtain information.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.GetVolumeRequest(volume_id: 'str', region: 'Optional[Region]')

Bases: object

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.IpfsV1Alpha1API(client: Client, *, bypass_validation: bool = False)

Bases: API

IPFS Pinning service API.

create_pin_by_cid(*, volume_id: str, cid: str, region: str | None = None, origins: List[str] | None = None, name: str | None = None) → Pin

Create a pin by CID. Will fetch and store the content pointed by the provided CID. The content must be available on the public IPFS network. The content (IPFS blocks) will be host by the pinning service until pin deletion. From that point, any other IPFS peer can fetch and host your content: Make sure to pin public or encrypted content. Many pin requests (from different users) can target the same CID. A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID. :param volume_id: Volume ID on which you want to pin your content. :param cid: CID containing the content you want to pin. :param region: Region to target. If none is passed will use default region from the config. :param origins: Node containing the content you want to pin. :param name: Pin name. :return: Pin

Usage:

result = api.create_pin_by_cid(
    volume_id="example",
    cid="example",
)

create_pin_by_url(*, volume_id: str, url: str, region: str | None = None, name: str | None = None) → Pin

Create a pin by URL. Will fetch and store the content pointed by the provided URL. The content must be available on the public IPFS network. The content (IPFS blocks) will be host by the pinning service until pin deletion. From that point, any other IPFS peer can fetch and host your content: Make sure to pin public or encrypted content. Many pin requests (from different users) can target the same CID. A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID. :param volume_id: Volume ID on which you want to pin your content. :param url: URL containing the content you want to pin. :param region: Region to target. If none is passed will use default region from the config. :param name: Pin name. :return: Pin

Usage:

result = api.create_pin_by_url(
    volume_id="example",
    url="example",
)

create_volume(*, name: str, region: str | None = None, project_id: str | None = None) → Volume

Create a new volume. Create a new volume from a Project ID. Volume is identified by an ID and used to host pin references. Volume is personal (at least to your organization) even if IPFS blocks and CID are available to anyone. Should be the first command you made because every pin must be attached to a volume. :param name: Volume name. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :return: Volume

Usage:

result = api.create_volume(
    name="example",
)

delete_pin(*, volume_id: str, pin_id: str, region: str | None = None) → None

Create an unpin request. An unpin request means that you no longer own the content. This content can therefore be removed and no longer provided on the IPFS network. :param volume_id: Volume ID. :param pin_id: Pin ID you want to remove from the volume. :param region: Region to target. If none is passed will use default region from the config.

Usage:

result = api.delete_pin(
    volume_id="example",
    pin_id="example",
)

delete_volume(*, volume_id: str, region: str | None = None) → None

Delete an existing volume. Delete a volume by its ID and every pin attached to this volume. This process can take a while to conclude, depending on the size of your pinned content. :param volume_id: Volume ID. :param region: Region to target. If none is passed will use default region from the config.

Usage:

result = api.delete_volume(
    volume_id="example",
)

get_pin(*, volume_id: str, pin_id: str, region: str | None = None) → Pin

Get pin information. Retrieve information about the provided pin ID, such as status, last modification, and CID. :param volume_id: Volume ID. :param pin_id: Pin ID of which you want to obtain information. :param region: Region to target. If none is passed will use default region from the config. :return: Pin

Usage:

result = api.get_pin(
    volume_id="example",
    pin_id="example",
)

get_volume(*, volume_id: str, region: str | None = None) → Volume

Get information about a volume. Retrieve information about a specific volume. :param volume_id: Volume ID. :param region: Region to target. If none is passed will use default region from the config. :return: Volume

Usage:

result = api.get_volume(
    volume_id="example",
)

List all pins within a volume. Retrieve information about all pins within a volume. :param volume_id: Volume ID of which you want to list the pins. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort order of the returned Volume. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :param status: List pins by status. :return: ListPinsResponse

Usage:

result = api.list_pins(
    volume_id="example",
)

List all pins within a volume. Retrieve information about all pins within a volume. :param volume_id: Volume ID of which you want to list the pins. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort order of the returned Volume. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :param status: List pins by status. :return: List[Pin]

Usage:

result = api.list_pins_all(
    volume_id="example",
)

List all volumes by a Project ID. Retrieve information about all volumes from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID, only volumes belonging to this project will be listed. :param order_by: Sort the order of the returned volumes. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :return: ListVolumesResponse

Usage:

result = api.list_volumes()

List all volumes by a Project ID. Retrieve information about all volumes from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID, only volumes belonging to this project will be listed. :param order_by: Sort the order of the returned volumes. :param page: Page number. :param page_size: Maximum number of volumes to return per page. :return: List[Volume]

Usage:

result = api.list_volumes_all()

replace_pin(*, volume_id: str, pin_id: str, cid: str, region: str | None = None, name: str | None = None, origins: List[str] | None = None) → ReplacePinResponse

Replace pin by CID. Deletes the given resource ID and pins the new CID in its place. Will fetch and store the content pointed by the provided CID. The content must be available on the public IPFS network. The content (IPFS blocks) is hosted by the pinning service until the pin is deleted. While the content is available any other IPFS peer can fetch and host your content. For this reason, we recommend that you pin either public or encrypted content. Several different pin requests can target the same CID. A pin is defined by its ID (UUID), its status (queued, pinning, pinned or failed) and target CID. :param volume_id: Volume ID. :param pin_id: Pin ID whose information you wish to replace. :param cid: New CID you want to pin in place of the old one. :param region: Region to target. If none is passed will use default region from the config. :param name: New name to replace. :param origins: Node containing the content you want to pin. :return: ReplacePinResponse

Usage:

result = api.replace_pin(
    volume_id="example",
    pin_id="example",
    cid="example",
)

update_volume(*, volume_id: str, region: str | None = None, name: str | None = None, tags: List[str] | None = None) → Volume

Update volume information. Update volume information (tag, name…). :param volume_id: Volume ID. :param region: Region to target. If none is passed will use default region from the config. :param name: Volume name. :param tags: Tags of the volume. :return: Volume

Usage:

result = api.update_volume(
    volume_id="example",
)

wait_for_pin(*, volume_id: str, pin_id: str, region: str | None = None, options: WaitForOptions[Pin, bool] | None = None) → Pin

Get pin information. Retrieve information about the provided pin ID, such as status, last modification, and CID. :param volume_id: Volume ID. :param pin_id: Pin ID of which you want to obtain information. :param region: Region to target. If none is passed will use default region from the config. :return: Pin

Usage:

result = api.get_pin(
    volume_id="example",
    pin_id="example",
)

class scaleway.ipfs.v1alpha1.IpfsV1Alpha1IpnsAPI(client: Client, *, bypass_validation: bool = False)

Bases: API

create_name(*, name: str, value: str, region: str | None = None, project_id: str | None = None) → Name

Create a new name. You can use the ipns key command to list and generate more names and their respective keys. :param name: Name for your records. :param value: Value you want to associate with your records, CID or IPNS key. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :return: Name

Usage:

result = api.create_name(
    name="example",
    value="example",
)

delete_name(*, name_id: str, region: str | None = None) → None

Delete an existing name. Delete a name by its ID. :param name_id: Name ID you wish to delete. :param region: Region to target. If none is passed will use default region from the config.

Usage:

result = api.delete_name(
    name_id="example",
)

export_key_name(*, name_id: str, region: str | None = None) → ExportKeyNameResponse

Export your private key. Export a private key by its ID. :param name_id: Name ID whose keys you want to export. :param region: Region to target. If none is passed will use default region from the config. :return: ExportKeyNameResponse

Usage:

result = api.export_key_name(
    name_id="example",
)

get_name(*, name_id: str, region: str | None = None) → Name

Get information about a name. Retrieve information about a specific name. :param name_id: Name ID whose information you want to retrieve. :param region: Region to target. If none is passed will use default region from the config. :return: Name

Usage:

result = api.get_name(
    name_id="example",
)

import_key_name(*, name: str, private_key: str, value: str, region: str | None = None, project_id: str | None = None) → Name

Import your private key. Import a private key. :param name: Name for your records. :param private_key: Base64 private key. :param value: Value you want to associate with your records, CID or IPNS key. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :return: Name

Usage:

result = api.import_key_name(
    name="example",
    private_key="example",
    value="example",
)

List all names by a Project ID. Retrieve information about all names from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort the order of the returned names. :param page: Page number. :param page_size: Maximum number of names to return per page. :return: ListNamesResponse

Usage:

result = api.list_names()

List all names by a Project ID. Retrieve information about all names from a Project ID. :param region: Region to target. If none is passed will use default region from the config. :param project_id: Project ID. :param organization_id: Organization ID. :param order_by: Sort the order of the returned names. :param page: Page number. :param page_size: Maximum number of names to return per page. :return: List[Name]

Usage:

result = api.list_names_all()

update_name(*, name_id: str, region: str | None = None, name: str | None = None, tags: List[str] | None = None, value: str | None = None) → Name

Update name information. Update name information (CID, tag, name…). :param name_id: Name ID you wish to update. :param region: Region to target. If none is passed will use default region from the config. :param name: New name you want to associate with your record. :param tags: New tags you want to associate with your record. :param value: Value you want to associate with your records, CID or IPNS key. :return: Name

Usage:

result = api.update_name(
    name_id="example",
)

wait_for_name(*, name_id: str, region: str | None = None, options: WaitForOptions[Name, bool] | None = None) → Name

Get information about a name. Retrieve information about a specific name. :param name_id: Name ID whose information you want to retrieve. :param region: Region to target. If none is passed will use default region from the config. :return: Name

Usage:

result = api.get_name(
    name_id="example",
)

class scaleway.ipfs.v1alpha1.IpnsApiCreateNameRequest(name: 'str', value: 'str', region: 'Optional[Region]', project_id: 'Optional[str]')

Bases: object

name: str: Name for your records.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

value: str: Value you want to associate with your records, CID or IPNS key.

class scaleway.ipfs.v1alpha1.IpnsApiDeleteNameRequest(name_id: 'str', region: 'Optional[Region]')

Bases: object

name_id: str: Name ID you wish to delete.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.IpnsApiExportKeyNameRequest(name_id: 'str', region: 'Optional[Region]')

Bases: object

name_id: str: Name ID whose keys you want to export.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.IpnsApiGetNameRequest(name_id: 'str', region: 'Optional[Region]')

Bases: object

name_id: str: Name ID whose information you want to retrieve.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.IpnsApiImportKeyNameRequest(name: 'str', private_key: 'str', value: 'str', region: 'Optional[Region]', project_id: 'Optional[str]')

Bases: object

name: str: Name for your records.

private_key: str: Base64 private key.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

value: str: Value you want to associate with your records, CID or IPNS key.

class scaleway.ipfs.v1alpha1.IpnsApiListNamesRequest(region: 'Optional[Region]', project_id: 'Optional[str]', organization_id: 'Optional[str]', order_by: 'Optional[ListNamesRequestOrderBy]', page: 'Optional[int]', page_size: 'Optional[int]')

Bases: object

order_by: ListNamesRequestOrderBy | None: Sort the order of the returned names.

organization_id: str | None: Organization ID.

page: int | None: Page number.

page_size: int | None: Maximum number of names to return per page.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.IpnsApiUpdateNameRequest(name_id: 'str', region: 'Optional[Region]', name: 'Optional[str]', tags: 'Optional[List[str]]', value: 'Optional[str]')

Bases: object

name: str | None: New name you want to associate with your record.

name_id: str: Name ID you wish to update.

region: str | None: Region to target. If none is passed will use default region from the config.

tags: List[str] | None: New tags you want to associate with your record.

value: str | None: Value you want to associate with your records, CID or IPNS key.

class scaleway.ipfs.v1alpha1.ListNamesRequestOrderBy(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CREATED_AT_ASC = 'created_at_asc'

CREATED_AT_DESC = 'created_at_desc'

class scaleway.ipfs.v1alpha1.ListNamesResponse(names: 'List[Name]', total_count: 'int')

Bases: object

names: List[Name]

total_count: int

class scaleway.ipfs.v1alpha1.ListPinsRequest(volume_id: 'str', region: 'Optional[Region]', project_id: 'Optional[str]', organization_id: 'Optional[str]', order_by: 'Optional[ListPinsRequestOrderBy]', page: 'Optional[int]', page_size: 'Optional[int]', status: 'Optional[PinStatus]')

Bases: object

order_by: ListPinsRequestOrderBy | None: Sort order of the returned Volume.

organization_id: str | None: Organization ID.

page: int | None: Page number.

page_size: int | None: Maximum number of volumes to return per page.

project_id: str | None: Project ID.

region: str | None: Region to target. If none is passed will use default region from the config.

status: PinStatus | None: List pins by status.

volume_id: str: Volume ID of which you want to list the pins.

class scaleway.ipfs.v1alpha1.ListPinsRequestOrderBy(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CREATED_AT_ASC = 'created_at_asc'

CREATED_AT_DESC = 'created_at_desc'

class scaleway.ipfs.v1alpha1.ListPinsResponse(total_count: 'int', pins: 'List[Pin]')

Bases: object

pins: List[Pin]

total_count: int

class scaleway.ipfs.v1alpha1.ListVolumesRequest(region: 'Optional[Region]', project_id: 'Optional[str]', order_by: 'Optional[ListVolumesRequestOrderBy]', page: 'Optional[int]', page_size: 'Optional[int]')

Bases: object

order_by: ListVolumesRequestOrderBy | None: Sort the order of the returned volumes.

page: int | None: Page number.

page_size: int | None: Maximum number of volumes to return per page.

project_id: str | None: Project ID, only volumes belonging to this project will be listed.

region: str | None: Region to target. If none is passed will use default region from the config.

class scaleway.ipfs.v1alpha1.ListVolumesRequestOrderBy(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CREATED_AT_ASC = 'created_at_asc'

CREATED_AT_DESC = 'created_at_desc'

class scaleway.ipfs.v1alpha1.ListVolumesResponse(volumes: 'List[Volume]', total_count: 'int')

Bases: object

total_count: int

volumes: List[Volume]

class scaleway.ipfs.v1alpha1.Name(name_id: 'str', project_id: 'str', tags: 'List[str]', name: 'str', key: 'str', status: 'NameStatus', value: 'str', region: 'Region', created_at: 'Optional[datetime]', updated_at: 'Optional[datetime]')

Bases: object

created_at: datetime | None

key: str

name: str

name_id: str

project_id: str

region: str: Region to target. If none is passed will use default region from the config.

status: NameStatus

tags: List[str]

updated_at: datetime | None

value: str

class scaleway.ipfs.v1alpha1.NameStatus(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

FAILED = 'failed'

PUBLISHED = 'published'

PUBLISHING = 'publishing'

QUEUED = 'queued'

UNKNOWN_STATUS = 'unknown_status'

class scaleway.ipfs.v1alpha1.Pin(pin_id: 'str', status: 'PinStatus', delegates: 'List[str]', created_at: 'Optional[datetime]', cid: 'Optional[PinCID]', info: 'Optional[PinInfo]')

Bases: object

cid: PinCID | None

created_at: datetime | None

delegates: List[str]

info: PinInfo | None

pin_id: str

status: PinStatus

class scaleway.ipfs.v1alpha1.PinCID(origins: 'List[str]', cid: 'Optional[str]', name: 'Optional[str]', meta: 'Optional[PinCIDMeta]')

Bases: object

cid: str | None

meta: PinCIDMeta | None

name: str | None

origins: List[str]

class scaleway.ipfs.v1alpha1.PinCIDMeta(id: 'Optional[str]')

Bases: object

id: str | None

class scaleway.ipfs.v1alpha1.PinDetails(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

CHECKING_COHERENCE = 'checking_coherence'

FAILED_CONTAINS_BANNED_CID = 'failed_contains_banned_cid'

FAILED_PINNING = 'failed_pinning'

FAILED_PINNING_BAD_CID_FORMAT = 'failed_pinning_bad_cid_format'

FAILED_PINNING_BAD_URL_FORMAT = 'failed_pinning_bad_url_format'

FAILED_PINNING_BAD_URL_STATUS_CODE = 'failed_pinning_bad_url_status_code'

FAILED_PINNING_NO_PROVIDER = 'failed_pinning_no_provider'

FAILED_PINNING_NO_URL_CONTENT_LENGTH = 'failed_pinning_no_url_content_length'

FAILED_PINNING_TIMEOUT = 'failed_pinning_timeout'

FAILED_PINNING_TOO_BIG_CONTENT = 'failed_pinning_too_big_content'

FAILED_PINNING_UNREACHABLE_URL = 'failed_pinning_unreachable_url'

FAILED_UNPINNING = 'failed_unpinning'

PINNED_OK = 'pinned_ok'

PINNING_BLOCKS_FETCHED = 'pinning_blocks_fetched'

PINNING_FETCHING_URL_DATA = 'pinning_fetching_url_data'

PINNING_IN_PROGRESS = 'pinning_in_progress'

PINNING_LOOKING_FOR_PROVIDER = 'pinning_looking_for_provider'

RESCHEDULED = 'rescheduled'

UNKNOWN_DETAILS = 'unknown_details'

UNPINNED_OK = 'unpinned_ok'

UNPINNING_IN_PROGRESS = 'unpinning_in_progress'

class scaleway.ipfs.v1alpha1.PinInfo(status_details: 'PinDetails', id: 'Optional[str]', url: 'Optional[str]', size: 'Optional[int]', progress: 'Optional[int]')

Bases: object

id: str | None

progress: int | None

size: int | None

status_details: PinDetails

url: str | None

class scaleway.ipfs.v1alpha1.PinStatus(value: str, names: Any | None = None, *args: Any, **kwargs: Any)

Bases: str, Enum

FAILED = 'failed'

PINNED = 'pinned'

PINNING = 'pinning'

QUEUED = 'queued'

UNKNOWN_STATUS = 'unknown_status'

class scaleway.ipfs.v1alpha1.ReplacePinRequest(volume_id: 'str', pin_id: 'str', cid: 'str', region: 'Optional[Region]', name: 'Optional[str]', origins: 'Optional[List[str]]')

Bases: object

cid: str: New CID you want to pin in place of the old one.

name: str | None: New name to replace.

origins: List[str] | None: Node containing the content you want to pin.

pin_id: str: Pin ID whose information you wish to replace.

region: str | None: Region to target. If none is passed will use default region from the config.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.ReplacePinResponse(pin: 'Optional[Pin]')

Bases: object

pin: Pin | None

class scaleway.ipfs.v1alpha1.UpdateVolumeRequest(volume_id: 'str', region: 'Optional[Region]', name: 'Optional[str]', tags: 'Optional[List[str]]')

Bases: object

name: str | None: Volume name.

region: str | None: Region to target. If none is passed will use default region from the config.

tags: List[str] | None: Tags of the volume.

volume_id: str: Volume ID.

class scaleway.ipfs.v1alpha1.Volume(id: 'str', project_id: 'str', region: 'Region', count_pin: 'int', tags: 'List[str]', name: 'str', created_at: 'Optional[datetime]', updated_at: 'Optional[datetime]', size: 'Optional[int]')

Bases: object

count_pin: int

created_at: datetime | None

id: str

name: str

project_id: str

region: str: Region to target. If none is passed will use default region from the config.

size: int | None

tags: List[str]

updated_at: datetime | None