Attestations

The following methods allow for interaction into the TVM PCI Attestation API API endpoints.

Methods available on tio.pci.attestations:

class AttestationsAPI(api: APISession)[source]
assets(id: ~uuid.UUID | str, *, sort: ~typing.List[tuple[str, ~typing.Literal['asc', 'desc']]] | None = None, limit: int = 1000, offset: int = 0, iterator: ~typing.Type[~tenable.io.pci.iterators.PCIAttestationAssetsIterator] | None = <class 'tenable.io.pci.iterators.PCIAttestationAssetsIterator'>) → PCIAttestationAssetsIterator | dict[str, Any][source]

Retrieves the list of assets associated to the attestation ID provided.

Parameters:

  • sort – Sort the results based on the field and sort order.

  • limit – The number of results to return for each page

  • offset – Where within the page data to start the page.

  • iterator – Should an iterator be returned or a page of data? If set to None, the page will be returned instead of the iterable.

details(id: UUID | str) → dict[str, Any][source]

Retrieves the details of a specific attestation.

Parameters:

id – The attestation UUID to retrieve.

disputes(id: ~uuid.UUID | str, *, sort: ~typing.List[tuple[str, ~typing.Literal['asc', 'desc']]] | None = None, limit: int = 1000, offset: int = 0, iterator: ~typing.Type[~tenable.io.pci.iterators.PCIDisputesIterator] | None = <class 'tenable.io.pci.iterators.PCIDisputesIterator'>) → PCIDisputesIterator | dict[str, Any][source]

Retrieves the list of disputes for the attestation ID provided.

Parameters:

  • sort – Sort the results based on the field and sort order.

  • limit – The number of results to return for each page

  • offset – Where within the page data to start the page.

  • iterator – Should an iterator be returned or a page of data? If set to None, the page will be returned instead of the iterable.

failures(id: ~uuid.UUID | str, *, sort: ~typing.List[tuple[str, ~typing.Literal['asc', 'desc']]] | None = None, limit: int = 1000, offset: int = 0, iterator: ~typing.Type[~tenable.io.pci.iterators.PCIUndisputedFailuresIterator] | None = <class 'tenable.io.pci.iterators.PCIUndisputedFailuresIterator'>) → PCIUndisputedFailuresIterator | dict[str, Any][source]

Retrieves the list of undisputed failures for the attestation ID provided.

Parameters:

  • sort – Sort the results based on the field and sort order.

  • limit – The number of results to return for each page

  • offset – Where within the page data to start the page.

  • iterator – Should an iterator be returned or a page of data? If set to None, the page will be returned instead of the iterable.

list(*, status_type: list[~typing.Literal['IN_PROGRESS', 'NEEDS_WORK', 'IN_REVIEW', 'INFO_REQUESTED', 'INFO_PROVIDED', 'FAILED', 'PASSED', 'CLOSED']] | None = None, sort: list[tuple[str, ~typing.Literal['asc', 'desc']]] | None = None, limit: int = 1000, offset: int = 0, iterator: ~typing.Type[~tenable.io.pci.iterators.PCIAttestationsIterator] | None = <class 'tenable.io.pci.iterators.PCIAttestationsIterator'>) → PCIAttestationsIterator | dict[str, Any][source]

Returns a list of PCI attestations.

Parameters:

  • status_type – Filters the attestations based on the status types defined.

  • sort – Sort the results based on the field and sort order.

  • limit – The number of results to return for each page

  • offset – Where within the page data to start the page.

  • iterator – Should an iterator be returned or a page of data? If set to None, the page will be returned instead of the iterable.